API reference
unsupported_platform, HTTP 422
The URL has no captions and is not on a platform AI transcription supports (YouTube, TikTok, Instagram, X, Facebook, or a direct media file).
Example response
{ "ok": false, "request_id": "req_...", "error": { "code": "unsupported_platform", "message": "The URL has no captions and is not on a platform AI transcription supports (YouTube, TikTok, Instagram, X, Facebook, or a direct media file)." } }
Why it happens
- The URL has no captions and is not on a platform AI transcription can serve. Audio transcription supports YouTube, TikTok, Instagram, X, Facebook, and direct media file URLs (mp4/mp3/wav/…).
- The URL points at an ordinary web page that happens to embed a player, rather than at the video itself.
How to fix it
- Send the video's own URL rather than the page it is embedded on.
- For a direct file, make sure the URL ends in a media extension and is reachable without authentication.
- To turn a page into text rather than a transcript, use POST /api/v1/web, which returns clean Markdown for any http(s) URL.
Retryable? No, not for this input. The same URL will always fail. Failed requests are never charged. Every error response carries a
request_id, include it when contacting support.