studio.trim_scene
Trim a generated scene's footage: cut milliseconds off its start and/or end. With ripple_secondary "shift" (the default) the other lanes follow the footage: time the scene loses at its start or end is cut from every lane at that edge, and time it gains is inserted there, so clips, captions and stickers stay over the frames they were placed on (one that spans that edge is split or stretched). "none" changes the main track alone. Refuses a shift that moves a locked track (unlock it with lock_track, or pass ripple_secondary "none").
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene_id | Yes | ||
| project_id | Yes | The studio project (vp_…) this tool acts on. | |
| trim_end_ms | No | Milliseconds to cut from the end. | |
| trim_start_ms | No | Milliseconds to cut from the start. | |
| ripple_secondary | No | "shift" (default) keeps clips, captions and stickers in sync with the scenes; "none" edits the main track alone. | shift |