Supported File Types
The Jobs API (from a URL or an upload), the x402 API, and the Edge API accept audio files and video files that have an audio track. The Edge API accepts the same file types as the Jobs API.
Supported Containers and Codecs
The API supports a wide range of common audio and video containers and codecs. The following table lists the combinations we tested with the Jobs API and its upload endpoint:
| File Extension | Container | Audio Codec | Video Codec | Notes |
|---|---|---|---|---|
.mp3 | MP3 | libmp3lame | N/A | Standard MP3 audio. |
.m4a | MP4 | AAC (Built-in) | N/A | AAC audio, typically using FFmpeg's built-in encoder. |
.opus | Ogg | Opus | N/A | Opus audio, often using libopus. |
.flac | FLAC | FLAC | N/A | Lossless audio. |
.wav | WAV | PCM (s16le) | N/A | Uncompressed PCM audio, 16-bit signed little-endian. |
.mp4 | MP4 | AAC | H.264 | Video with AAC audio. |
.mp4 | MP4 | AAC | H.265 | Video with AAC audio. |
.webm | WebM | Opus | VP9 | Video with Opus audio. |
.webm | WebM | Opus | AV1 (SVT-AV1) | Video with Opus audio, using the SVT-AV1 encoder. |
.ogg | Ogg | Vorbis | Theora | Video with Vorbis audio. |
Note: Other combinations of containers and codecs may work. If a file in a format that isn't listed here fails, contact support.
General Guidelines
- The service detects the container and codec of the input file automatically.
- For best results, use standard, widely supported codecs such as standard MP3 audio.
- If your file uses a less common codec, convert it to a more common format before you transcribe it: MP3 for audio, or H.264 video with AAC audio in an MP4 container for video.
MIME Types Accepted by Upload
The upload endpoints of the Jobs API and the x402 API identify a file by its content. They ignore the file name and the Content-Type header. A file is accepted when its content is detected as one of these MIME types:
| Format | MIME Types |
|---|---|
| MP3 | audio/mpeg |
| M4A | audio/mp4, audio/x-m4a |
| MP4 | video/mp4 |
| Ogg | audio/ogg, audio/ogg; codecs=opus, video/ogg |
| FLAC | audio/flac, audio/x-flac |
| WAV | audio/wav |
| WebM | audio/webm, video/webm |
Any other content is rejected with Unsupported file type detected. Converting the file to a listed format fixes this. Renaming it does not. To name an uploaded file, see Uploads.