build_video
Creates a finished social video from ordered clips by adding transitions, voiceover, captions, music, title and end cards, then exports it in platform-ready formats.
Instructions
ONE call for a finished video. clips: video names in order, or {"video", "start", "end", "speed"} to cut/speed one. transition: cut | fade | crossfade. shape: "9:16" (Shorts/Reels/TikTok) | "1:1" | "4:5" | "16:9". voice: the words to say (or {"text", "voice": andrew|emma|ava|brian|es|pt..., "engine": edge|local, "sample"} or {"audio": file}). captions: "auto" (timed to the voice) or your own text. music: a music file path (or {"file", "volume"}); it gets quieter under the voice. title: text for a card at the start. end_card: text for the last card (true = "Follow for more"). export: shorts | reels | tiktok | facebook | youtube | x | square (right size and format to post). Only the final video stays in the gallery.
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": {
"clips": "<clips>"
},
"name": "build_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clips | Yes | ||
| music | No | ||
| shape | No | ||
| title | No | ||
| voice | No | ||
| export | No | ||
| captions | No | ||
| end_card | No | ||
| transition | No | crossfade |