Skip to main content
POST
Create a transcript

Authorizations

Authorization
string
header
required

An API key: Authorization: Bearer mbk_live_...

Headers

Idempotency-Key
string
required

A unique key per transcript you want. Reuse it only to retry the same request.

Required string length: 8 - 160

Body

application/json
upload_id
string<uuid>
required
duration_ms
integer
required

The recording's length (20 seconds to 3 hours). The price is based on it, and it is checked against the file.

Required range: 20000 <= x <= 10800000
config
object

How the transcript is made. Unknown fields are rejected. The playground's Export config writes this object.

Response

Transcript queued

id
string<uuid>
object
string
Allowed value: "transcript"
model
string
status
enum<string>
Available options:
queued,
processing,
completed,
failed,
canceled
file_name
string
speaker_names
object
config
object

How the transcript is made. Unknown fields are rejected. The playground's Export config writes this object.

duration_ms
integer
error
string | null

Why it failed or was canceled.

cost
object
created_at
string<date-time>
completed_at
string<date-time> | null
Last modified on October 26, 2026