Skip to main content
POST
Create Transcription Job From Url

Authorizations

X-API-Key
string
header
required

Body

application/json

Defines the request body for the non-streaming transcription endpoint. Accepts an audio source as a URL or a data URI.

audio
required

A publicly accessible URL to an audio file OR a base64-encoded data URI.

Minimum string length: 1
Example:

"https://filesamples.com/samples/audio/mp3/sample-3.mp3"

context
string | null

Optional context to guide the ASR model. Doubles cost and increases latency.

Maximum string length: 1000
formatting
FormattingOptions · object | null

Rules for applying formatting to the final transcript based on detected pauses.

apply_contextual_correction
boolean | null
default:false

If true, performs an additional AI pass to correct contextual errors. Requires 'context' to be effective.

Response

Successful Response

Response model when a non-streaming job is successfully queued.

job_id
string<uuid>
required
status
string
default:queued
detail
string
default:Your transcription job has been successfully queued.