Add subtitles to a video
add_subtitlesBurn subtitles into video without cutting or re-rendering; optionally get an .srt file, with word- or sentence-timed captions, custom cues, or highlighted spoken words.
Instructions
Burn subtitles into ANY video and get the .srt too; nothing is cut or re-rendered. Set textStyle only when the user describes a look (default: white sentence case, thin outline, bottom). Timed by the spoken words (up to 5 words a line); auto:'sentences' times per sentence. Only when asked, textStyle 'highlight' (or a highlightColor) lights the word being said, timed word by word. Or pass cues to burn your own lines exactly, untranscribed (reel-style phrases, stage directions). burn:false returns only the .srt. Takes a video file or URL, a Vimeo-style page, or a TikTok / Reel / X post link (not YouTube: YouTube does not let us download videos, so upload the file). No speech is refused and refunded. Runs in the background and lands in the Library.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video": "<video>"
},
"name": "add_subtitles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto | No | words (default) or sentences: timing unit for transcribed subtitles | |
| burn | No | false = only the .srt | |
| cues | No | your own lines in seconds, no overlap, max 90 chars, no emoji | |
| video | Yes | the video to subtitle; a URL, not a local file path; use upload_file for local files | |
| script | No | the words actually spoken, when you have them: the subtitles then use these words and take only the timing from the audio (a video we rendered already knows its script) | |
| get_cost | No | true: return the price only; nothing runs or bills | |
| textStyle | No | the look: words, a preset or fields; omit for the default | |
| wordsPerCue | No | words per subtitle line when timed by words | |
| idempotency_key | No | chosen once, resent unchanged on retries: the same key never buys twice | |
| expected_credits | No | the get_cost price; refused unbilled if the live price differs |