Re-cut a clip from an edited segment list
recut_clipRe-render one clip from a new list of source-video segments (the same engine behind the dashboard's clip editor). Times are seconds in the ORIGINAL source video: start from the clip's source_segments in list_clips (e.g. end 5 s earlier = lower the last end by 5). Segments are concatenated in the given order, so you can trim, extend, drop a dead moment in the middle, or reorder. Segments inside the clip's original range re-render in seconds; going outside needs the retained source video and re-runs the reframe engine.
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>",
"segments": "<segments>"
},
"name": "recut_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| framing | No | Layout override: 'full' shows the whole source frame (no side-cropping), 'track' forces the subject-tracking crop, 'auto' resets to the AI classifier. Omit to keep the clip's current framing. Non-auto values re-run the reframe engine and need the retained source video. | |
| segments | Yes | Ordered source segments the new clip is made of. | |
| clip_index | Yes | 0-based index from list_clips. | |
| snap_to_words | No | Snap each boundary onto transcript word boundaries (recommended). | |
| reapply_captions | No | Burn default captions back on after the recut (default true). |