Clip a video or stream
queue_videoSubmit a YouTube, Twitch, Kick, or local video to find highlight moments, crop them to vertical, add captions, and return a job ID for tracking.
Instructions
Hand Clips Kitty a YouTube, Twitch or Kick link and it finds the moments worth posting, crops them to vertical and captions them, all on this computer. Returns a job id; processing a long stream takes a while.
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": {
"url": "<url>"
},
"name": "queue_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube, Twitch or Kick link | |
| focus | No | What the person wants the clips to be about or to include, in their own words: a topic they talk about, a moment that happened, a time range ("1:35-1:55", "near the end"), or a style (funny moments, laughing, hype, reactions). Pass their sentence as written, keeping words like "make sure" and "at least two": those make it a must-have. It adds weight to those moments and never removes others, so "avoid X" is not something it can do. | |
| force | No | Process again even if this video was done before | |
| sport | No | The video is a match or a game: its moments (soccer: goals, saves, cards; basketball: dunks, threes, blocks, game winners, and the crowd, bench and courtside reactions) are found from the crowd, the commentary and the scoreboard, one clip per moment with its build-up and reaction, framed to follow the play. Not with gaming or podcast. | |
| gaming | No | A game stream: the streamer's webcam in one half and the game in the other, or the game filling the screen when there is no webcam. The streamer is whoever speaks in sync with the audio, never the biggest face. Not with vertical_live, podcast or longform. | |
| podcast | No | Multi-camera podcast footage: framing cuts per shot | |
| captions | No | Burn captions into the clips. On unless set to false. | |
| hashtags | No | Hashtags every clip from this video must carry, in its title line and description. Use when they name a tag they want on all of them; do not set metadata clip by clip afterwards instead. | |
| longform | No | Make horizontal 1920x1080 video instead of vertical clips. short_clips = up to 60s. clips_140 = up to 140s, for X. highlights = one best-of video, 8-20 min. edited_stream = the whole stream with the downtime removed. Leave unset for normal vertical clips. | |
| pipeline | No | An installed, enabled SDK pipeline. For a Gaming detector also set gaming=true. Use its actual id, never guess. | |
| max_clips | No | Cap clips from this video | |
| min_score | No | Quality bar, 0-100 | |
| watermark | No | Name of a saved branding profile to put on every clip. Names are matched loosely; a wrong one lists the real ones. | |
| long_clips | No | 61-180s vertical clips instead of 10-60s. Still 9:16 for TikTok and Shorts. For a wide 16:9 video use longform. | |
| caption_style | No | How the burned-in captions look. Set only what was asked for; anything left out keeps the saved setting. | |
| gaming_layout | No | The existing Gaming layout and webcam/game boxes, validated by the engine. Omit to use Gaming's automatic layout detector. Set only from the user's chosen layout. | |
| vertical_live | No | The video is a livestream that was already vertical (9:16) when streamed: keep its own layout, no face tracking or reframing. Refused if the video is not 9:16. Not with podcast or longform. | |
| publish_when_done | No | Platforms to publish every clip to as soon as processing finishes, e.g. ["youtube"]. Use this when they ask you to process a video AND publish it: the clips do not exist yet while you are replying, so there is nothing to publish until the job completes. |