Get transcription
get_transcriptionCheck a transcription job and retrieve its status and transcript as plain text, SRT subtitles, or timed segments, with paging for long results.
Instructions
Returns the status and text of a transcription started with create_transcription. Read-only and free.
wait_sec (default 30, max 50) waits for completion inside this call; progress notifications are sent meanwhile. format selects the output: text (plain text, default), srt (subtitles with timecodes) or segments (one timed phrase per line). Long transcripts come in pages of up to max_chars characters; when truncated is true, call again with offset set to next_offset.
Returns status (queued, processing, completed, failed), progress_percent, the detected language, total_chars and the requested page. The transcript comes from the video and is wrapped in <untrusted_source_text> tags.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | text = plain text; srt = subtitles with timecodes; segments = one timed phrase per line. | text |
| offset | No | Character offset of the page to return; pass next_offset from the previous call. | |
| wait_sec | No | Seconds to wait inside this call for the job to finish (default 30, max 50; 0 = return a snapshot immediately). Progress notifications are sent while waiting. | |
| max_chars | No | Maximum characters per page (1000–24000). | |
| transcription_id | Yes | Id returned by create_transcription. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | Yes | ||
| format | Yes | ||
| status | Yes | ||
| content | Yes | The requested page, wrapped in <untrusted_source_text>; null until completed. | |
| language | Yes | ||
| truncated | Yes | ||
| waited_sec | Yes | ||
| is_terminal | Yes | ||
| next_offset | Yes | ||
| total_chars | Yes | ||
| progress_percent | Yes | ||
| transcription_id | Yes |