Retrieve the transcript formatted as subtitles in SRT, VTT, or plain text format. Only available for completed transcriptions.
Returns the transcript formatted as subtitle content in the requested format. The response is raw text (not JSON) with the appropriate Content-Type header. Supported formats are:
srt-- SubRip subtitle format (text/plain)vtt-- WebVTT subtitle format (text/vtt)txt-- Plain text format (text/plain)
You can control caption formatting with query parameters for characters per caption, maximum lines, and characters per line.
Supports ETag caching with Cache-Control: public, max-age=86400 for completed transcriptions.
When PII redaction was enabled, the response includes X-PII-Redacted and X-PII-Policies headers.
transcription_id string required
The transcription ID with trans_ prefix.
format string required
Subtitle format. One of: srt, vtt, txt.
chars_per_caption integer optional · Defaults to 0
Maximum characters per caption. Set to 0 for no limit. Must be between 0 and 512.
max_lines integer optional · Defaults to 2
Maximum number of lines per caption. Must be between 1 and 3.
max_chars_per_line integer optional · Defaults to 42
Maximum characters per line within a caption. Must be between 20 and 60.
Returns raw text content with the appropriate Content-Type header:
- SRT:
text/plain-- Standard SubRip format with sequential numbering and timestamp lines. - VTT:
text/vtt-- WebVTT format withWEBVTTheader and timestamp cues. - TXT:
text/plain-- Plain text without timestamps.
On error, returns a JSON error envelope instead.
Response headers include ETag, Last-Modified, and Cache-Control.
- Bash
- Bash
- Python
- Python
- JavaScript
curl -s -X GET "https://api.aitronos.com/v1/audio/transcribe/trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6/subtitles/srt?chars_per_caption=80&max_lines=2" \
-H "Authorization: Bearer $ACCESS_TOKEN"