video_add_text
Overlay text such as a title, caption, or watermark onto a video, set its position and timing, and save the edited output.
Instructions
Burn one text element (title, caption, watermark) into a video. Returns JSON {success, output_path}.
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": {
"input_path": "<input_path>",
"text": "<text>"
},
"name": "video_add_text"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crf | No | Override CRF value (0-51, lower = better quality). Default 23. | |
| font | No | Path to font file. Uses system default if omitted. | |
| size | No | Font size in pixels. | |
| text | Yes | Text to overlay. | |
| color | No | Text color (CSS color name or hex). | white |
| preset | No | Override FFmpeg encoding preset (ultrafast, fast, medium, slow, veryslow). | |
| shadow | No | Add text shadow for readability. | |
| duration | No | How long text is visible (seconds). Requires start_time. | |
| position | No | Named (top-left, top-center, ...), pixels {"x": 100, "y": 50}, or fractions {"x_pct": 0.5, "y_pct": 0.5}. | top-center |
| overwrite | No | Allow replacing existing media files. | |
| input_path | Yes | Absolute path to the input video. | |
| start_time | No | When the text appears (seconds). Null = always visible. | |
| output_path | No | Where to save the output. Auto-generated if omitted. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||