caption_video
Captions local video or audio files, exporting burned-in MP4, transparent MOV/WebM overlay, or SRT/VTT subtitles while rendering locally so media never uploads.
Instructions
Captions a local video or audio file with the Cuecaps studio's renderer in headless Chrome or Edge and writes .captions. next to it, never replacing a file: an MP4 with the captions burned in, a transparent MOV or WebM overlay, or SRT or VTT subtitles. Returns the file, its duration in seconds, the engine, the cloud minutes used and a studio link to fine-tune words and style. Needs a Creator or Pro key; 1440p and 4K need Pro. Transcription works as in transcribe, and the video never leaves this machine. Use transcribe when only the words are needed, and studio_link when the user wants to edit by hand or has no key.
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": {
"path": "<path>"
},
"name": "caption_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | Frames per second. | |
| lang | No | The spoken language. Give it for any video that isn't in English; auto lets cloud transcription detect it. | |
| path | Yes | Absolute path to the video or audio file: MP4, MOV, WebM, MP3, WAV, M4A or another format the studio opens. | |
| lines | No | Lines per caption. | |
| style | No | Caption style. list_styles shows how each one looks. | |
| words | No | Words per caption; 1 shows one word at a time. | |
| aspect | No | Frame shape: 9:16 for TikTok, Shorts and Reels, 1:1 or 4:5 for feed posts, 16:9 for YouTube. | |
| engine | No | cloud: ElevenLabs Scribe on the plan's cloud minutes, strongest on music, accents and 90+ languages; the default when the minutes left cover the file. device: on-device Whisper, no minutes; the first run downloads the model (132 MB). | |
| output | No | mp4 with the captions burned in, mov or webm as a transparent captions-only overlay, or srt or vtt subtitles. Defaults to out_path's extension when out_path is given, else mp4. | |
| keyterms | No | Names and words for cloud transcription to spell your way. | |
| out_path | No | Absolute path to write to instead of <name>.captions.<ext> next to the input, ending in .mp4, .mov, .webm, .srt or .vtt; its extension sets output. An existing file is never replaced: -2, -3 and so on go before the extension. | |
| position | No | Where the captions sit in the frame. | |
| resolution | No | Short side of the video. 1440p and 4k come with Pro. | 1080p |