Clip a long video
clip_videoCut one long video into several ranked, self-contained short clips with burned-in captions, ready to post to Reels, Shorts, or TikTok.
Instructions
Cut ONE long video into several RANKED, ready-to-post short clips (podcast, webinar, interview, talk, long ad cut -> Reels/Shorts/TikTok). Transcribes with timestamps, picks the strongest SELF-CONTAINED moments, then cuts + reframes each with ffmpeg — no video model renders anything, so it is fast and cheap. NOT supported: TikTok / Instagram / Facebook links, and anything age-restricted, private, members-only, geo-blocked or still LIVE — those fail fast with the real reason and are fully refunded, so ask for a direct file or an upload rather than retrying. SUBTITLES ARE BURNED IN BY DEFAULT (white sentence case timed by the spoken words, thin black outline, bottom safe band, no box) because short-form is watched on mute; captions:false for clean footage. TIMING IS APPROXIMATE (per-sentence, not word-level); never promise frame-accurate sync. Full rules: get_instructions({topic:'clip_video'}).
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": "clip_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | how many clips to cut, 1-8 (default 4) | |
| video | Yes | the long video to clip — a Vimeo/Loom/Dailymotion/Streamable/Rumble/Wistia/Twitch/TED watch URL, a direct https .mp4/.mov/.webm, or a Hermoso /generated/ URL; a URL, not a local file path; use upload_file for local files | |
| captions | No | burn subtitles into every clip. DEFAULT TRUE — a clip cut from a podcast or a talk is watched on mute, and the words are the product. Set false for clean footage. A clip whose window carries no readable speech is delivered bare rather than captioned with a guess, and the result says which. | |
| get_cost | No | true: return the price only; nothing runs or bills | |
| aspectRatio | No | clip shape: '9:16' (default), '1:1', '16:9', any 'W:H', or 'keep' for the source framing | |
| 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 |