Burn styled captions onto a clip
add_subtitlesRe-style the captions of one clip (clips already ship with the 'default' preset). Easiest: pass a preset; any other field you send overrides that part of it. Without a preset, style 'karaoke' highlights the active word.
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": {
"job_id": "<job_id>",
"clip_index": "<clip_index>"
},
"name": "add_subtitles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| style | No | ||
| effect | No | Karaoke active-word effect; 'highlight' = solid box behind it. | |
| job_id | Yes | ||
| preset | No | default: Anton caps, yellow active word. hormozi: words appear as spoken, yellow active word. pill: purple box behind the active word. lime: lime box behind the active word. oneword: one big word at a time. clean: no outline, soft shadow, sentence case. | |
| reveal | No | Karaoke: words appear as they are spoken. | |
| shadow | No | Drop shadow depth 0-6. | |
| one_word | No | Show one word at a time. | |
| position | No | ||
| font_name | No | Anton, Montserrat ExtraBold, Verdana, Arial, Impact, Georgia... | |
| font_size | No | 44 is the default (M); 34 = S, 56 = L, 70 = XL. | |
| uppercase | No | ||
| clip_index | Yes | 0-based index from list_clips. | |
| font_color | No | Hex color, e.g. #FFFFFF. | |
| border_width | No | Outline 0-10 (0 needs a shadow to stay readable). | |
| highlight_color | No | Karaoke active-word color (or box color with effect 'highlight'). |