studio.cut_transcript_span
Cut the words of a transcript span out of the whole video, the way deleting text in a transcript editor does. The span runs from from_caption_id to to_caption_id (row ids from get_transcript) and takes both rows whole; from_word_index and to_word_index narrow it to a word inside the from row and the to row (0-based, in the order get_transcript lists a row's words). The span's time comes out of every lane through the same cut as cut_range, so the scenes, clips, captions and stickers after it move earlier together, and a transcribed row that loses words keeps the words that are left. cut_start_ms and cut_end_ms report the range applied, which is wider than the span when a scene edge needs it. Not undoable. Refuses, naming the fix: an unknown caption id, a span that runs backwards, a word index on a manual caption or a silence row (neither has word timings, so it cuts only as a whole row), a word index past the row's last word, a span that covers no time, a locked track after the span, and whatever else cut_range refuses there (a span past the timeline end, a scene split with no room).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | The studio project (vp_…) this tool acts on. | |
| to_caption_id | Yes | The caption row (vc_) the span ends in; the same id as from_caption_id for a span inside one row. | |
| to_word_index | No | 0-based index of the last word to cut in the to row; the row's end when left out. | |
| from_caption_id | Yes | The caption row (vc_) the span starts in. | |
| from_word_index | No | 0-based index of the first word to cut in the from row; the row's start when left out. |