Cut.ProDocs
Transcriptions

Download the transcript as a subtitle file

Returns the transcript as a ready-to-use subtitle file (srt by default, vtt or txt) with the matching Content-Type and a Content-Disposition filename. The body is the file itself, not JSON.

Speaker names are written into the file only when the job was billed with speaker_labels; pass speakers=false to leave them out of a diarized transcript.

Returns 404 TRANSCRIPTION_NOT_READY while the worker is still running.

Authorization

apiKey
X-Api-Key<token>

In: header

Path Parameters

transcriptionId*string

Query Parameters

format?string

Value in

  • "srt"
  • "vtt"
  • "txt"
speakers?boolean

Include speaker names. Default true, and inert unless the job was diarized.

Response Body

text/plain

application/json

GET
/transcriptions/{transcriptionId}/download
curl -X GET "https://example.com/transcriptions/string/download"
"string"

Get the transcript as JSON GET

Returns the transcript as timed cues, ready to render or index without parsing a subtitle file. Timings are in seconds from the start of the audio. `speaker` is only ever filled when the job was billed with `speaker_labels`; on every other job it is `null`. Returns `404 TRANSCRIPTION_NOT_READY` while the worker is still running.