Create Transcription
Transcribes an audio file and processes the transcript through an LLM. Returns a unique request id and status.
Request body
Depending on the selected source of the file, you will use either the URL or File parameters. The URL should link to the publicly available file on your/remote server. The file size is limited to 200 MB. Contact support here if you need larger uploads.
The language of the audio. Provide the input language in ISO-639-1 format. If nothing is provided, auto-detection will occur by the first seconds of the audio. Supported language codes: af, ar, az, be, bg, bs, ca, cs, cy, da, de, el, en, es, et, fa, fi, fr, gl, he, hi, hr, hu, hy, id, is, it, ja, kk, ko, lt, lv, mi, mk, ms, ne, nl, no, pl, pt, ro, ru, sk, sl, sr, sv, sw, th, tr, uk, vi, zh
Optional prompt to define special vocabulary or guide the model to correctly transcribe namings and terminology. Should match the input language.
Voice activity detection filter used to cut out the silences and speed up the transcription process. When having a low-level input file or low-quality file it is recommended to run the request with the false option.
Options: true or false.
By default, the model will diarize the file and return the transcript with text allocated to detected speakers.
Options: true or false.
Webhook URL to be called by POST method to return the results after processing is completed or failed. The service will attempt delivery 3 times with a 60-second delay between attempts. When delivering processing results, the task status changes to WEBHOOK_DELIVERED or WEBHOOK_FAILED. When delivering processing errors, the status does not change.
Any ID value you need to identify your initial request that will be sent to Webhook when returning the result. This parameter is passed in the request headers as x-callback-id, as well as in the response body.
Returns
Possible statuses:
ACCEPTED - request accepted by the API service
IN_QUEUE - request in the queue for transcription
IN_PROGRESS - request being transcribed
COMPLETED - processing completed if no callback_url is set
WEBHOOK_DELIVERED - processing completed, webhook successfully delivered to the set callback_url
WEBHOOK_FAILED - webhook delivery failed to the set callback_url
FAILED - processing error with error text