Create transcription

Transcribes audio into the input language using a unified OpenAI-compatible multipart interface.
Supports non-streaming JSON responses and, for capable OpenAI models, SSE streaming.

Required fields (this endpoint):

FieldDescription
fileAudio (or video) file to transcribe (format: binary).
modelModel id in provider/model format (e.g. openai/gpt-4o-transcribe, elevenlabs/scribe_v2).

Provider-native requirements (mapped via model prefix; see linked docs for full rules):

ProviderNative APIRequired upstream
OpenAICreate transcriptionfile, model
ElevenLabsCreate transcriptmodel_id, and either file or source_url

On this endpoint always send file + model. ElevenLabs URL-based input (source_url) is only available
when the platform exposes it for elevenlabs/* models.

Optional parameters depend on the provider. Common examples:

  • OpenAIlanguage, prompt, response_format (json, text, srt, verbose_json, vtt, diarized_json),
    temperature, timestamp_granularities[], stream, include[], chunking_strategy, known_speaker_names[],
    known_speaker_references[] (diarization models).
  • ElevenLabslanguage_code, diarize, num_speakers, timestamps_granularity, tag_audio_events,
    use_multi_channel, keyterms, webhook, source_url, entity_detection, temperature, seed, and others
    listed in ElevenLabs Speech-to-Text.

The set of accepted optional fields and response fields may differ between providers and models.
Use the model/info endpoint to check capabilities (e.g. streaming, diarization, word timestamps).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Multipart form data. file and model are always required on this endpoint.

Additional fields are provider-specific; see the operation description for OpenAI vs ElevenLabs parameter
comparison. Parameters not supported by the selected provider/model may be ignored or return 400.

Unified transcription request. Required: file, model (provider/model).

Optional fields below are a non-exhaustive union of provider parameters — send only those supported
by your chosen model. See OpenAI Create transcription
and ElevenLabs Speech-to-Text.

file
required

The audio or video file to transcribe.

OpenAI — flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm (see OpenAI docs).
ElevenLabs — all major audio/video formats; minimum ~100 ms audio; max file size per ElevenLabs docs.

string
required

Model id in provider/model format. Required.

Examples: openai/gpt-4o-transcribe, openai/whisper-1, openai/gpt-4o-transcribe-diarize,
elevenlabs/scribe_v2, elevenlabs/scribe_v1.

string

OpenAI — ISO-639-1 language of the audio (e.g. en). Improves accuracy when known.
ElevenLabs — use language_code (ISO-639-1 or ISO-639-3) instead when calling ElevenLabs models.

string

ElevenLabs only — ISO-639-1 or ISO-639-3 language code. Omit to auto-detect.
OpenAI models use language instead.

string

OpenAI only — optional text to guide style or continue a previous transcript segment.

string

OpenAI only — output format: json, text, srt, verbose_json, vtt, or diarized_json
(diarization models). ElevenLabs returns its native JSON shape regardless of this field.

boolean

OpenAI only (supported models) — when true, response is text/event-stream with transcript deltas.
Not supported for whisper-1 or ElevenLabs models on this endpoint.

number

OpenAI — sampling temperature for transcription.
ElevenLabs — randomness 0.0–2.0 (model-dependent default when omitted).

boolean

ElevenLabs only — annotate which speaker is talking. OpenAI diarization uses
openai/gpt-4o-transcribe-diarize with response_format=diarized_json instead.

integer

ElevenLabs only — max speakers in the file (helps diarization; up to 32).

string

ElevenLabs onlynone, word, or character. OpenAI uses timestamp_granularities[]
with response_format=verbose_json on whisper-1.

keyterms
array of strings

ElevenLabs only — terms/phrases to bias recognition toward (max 1000 terms).

keyterms
string

ElevenLabs only — URL of hosted audio/video (YouTube, TikTok, HTTPS file URL, etc.) as an
alternative to file. Native ElevenLabs API requires file or URL; on this endpoint file
remains required unless platform documents URL-only routing for ElevenLabs.

boolean

ElevenLabs only — when true and the audio has multiple channels, returns separate transcripts
per channel (max 5 channels). See ElevenLabs multichannel response example.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/event-stream