Create transcription
Upload one audio file and transcribe it with Finch. Send finch_indic_1.0 to https://in.api.murf.ai and finch_global_1.0 to https://us-east.api.murf.ai. A model or language served by the other host returns 400 with redirect_url. Authenticate with the api-key header. xi-api-key, Authorization: Bearer, and the api_key query parameter also work; if more than one is sent, the query parameter is used, then the api-key or xi-api-key header, then Bearer. Prefer the api-key header. The query parameter puts the key in URLs and logs. POST /v1/transcription/upload calls this same handler; use this path. Without webhook, the call returns 200 with the transcript. If the job is still running after 20 seconds, the server sends the 200 headers and then a space every 10 seconds until the JSON is ready. A failure after those headers is a detail object in that same body. The synchronous wait stops at 600 seconds and the job keeps running; poll it with the transcription_id. With webhook=true the call returns 202, and Murf later POSTs the result to webhook_url. That POST is not signed. Set a hard-to-guess webhook_url. See the File transcription guide for the webhook body, retries, and polling.
Headers
Your Murf API key. xi-api-key, Authorization: Bearer, and the api_key query parameter also authenticate this call. If more than one is sent, the query parameter is used, then the api-key or xi-api-key header, then Bearer. Avoid the query parameter: the key is stored in URLs and access logs.
Request
Audio file. WAV, FLAC, or OGG (Vorbis or Opus). M4A, AAC, MP4, and WebM cannot be decoded. Stereo is mixed down to mono and the audio is resampled to 16 kHz. Maximum upload 1 GB. Maximum audio length 3600 seconds.
Required, unless model_id is sent. finch_indic_1.0 on in.api.murf.ai, or finch_global_1.0 on us-east.api.murf.ai.
A language tag for the model, such as hi or en_IN. Omit it, or send auto, to detect the language.
Beta. true returns 202 and delivers the result to webhook_url.
Required when webhook is true. Murf POSTs the result here. The request is not signed. Use a hard-to-guess URL.
Response
Omitted when timestamps_granularity is none.