Skip to navigation

Submit transcription job

View as Markdown

Uploads an audio file and queues an asynchronous transcription job. The call returns as soon as the job is accepted — poll GET /v1/transcription/jobs/{job_id} for the transcript. The request body is capped at 32 MB; anything larger is rejected with 413 before the body is read.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a multipart form containing a file.
audiofileRequired

Audio file to transcribe. Required, and must be non-empty.

languagesstringOptional

Language hint. Pass a single code — the value is forwarded to the engine unchanged, so a comma-separated list is validated but not split. Every code must be one of: unknown, as-IN, bn-IN, brx-IN, doi-IN, en-IN, gu-IN, hi-IN, kn-IN, kok-IN, ks-IN, mai-IN, ml-IN, mni-IN, mr-IN, ne-IN, od-IN, pa-IN, sa-IN, sat-IN, sd-IN, ta-IN, te-IN, ur-IN. Omit the field, or pass unknown, to let the engine detect the language.

diarizebooleanOptional

Return speaker-attributed utterances. Defaults to the workspace setting (enabled by default) when omitted.

formatenumOptionalDefaults to standard

standard transcribes in the spoken language’s own script. code_mixed is for audio that switches between English and an Indian language mid-sentence.

Allowed values:

Response

Job accepted and queued
idstring

Job id. Pass it to GET /v1/transcription/jobs/{job_id}, and store it — jobs cannot be listed.

enginestring
Transcription engine that accepted the job.
statusenum

Always pending on submit — the job runs asynchronously.

Allowed values:

Errors

400
Bad Request Error
401
Unauthorized Error
413
Content Too Large Error
422
Unprocessable Entity Error
429
Too Many Requests Error
502
Bad Gateway Error