Skip to main content

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 ExtensionContainerAudio CodecVideo CodecNotes
.mp3MP3libmp3lameN/AStandard MP3 audio.
.m4aMP4AAC (Built-in)N/AAAC audio, typically using FFmpeg's built-in encoder.
.opusOggOpusN/AOpus audio, often using libopus.
.flacFLACFLACN/ALossless audio.
.wavWAVPCM (s16le)N/AUncompressed PCM audio, 16-bit signed little-endian.
.mp4MP4AACH.264Video with AAC audio.
.mp4MP4AACH.265Video with AAC audio.
.webmWebMOpusVP9Video with Opus audio.
.webmWebMOpusAV1 (SVT-AV1)Video with Opus audio, using the SVT-AV1 encoder.
.oggOggVorbisTheoraVideo 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:

FormatMIME Types
MP3audio/mpeg
M4Aaudio/mp4, audio/x-m4a
MP4video/mp4
Oggaudio/ogg, audio/ogg; codecs=opus, video/ogg
FLACaudio/flac, audio/x-flac
WAVaudio/wav
WebMaudio/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.