用途
本产品用于从长视频（访谈、讲座、直播回放、口播）中切出可单独发布的短视频片段。刷到短视频的人没看过长视频，也不知道前文，因此每支短视频必须自己站得住：开头是钩子，只讲一件事，停在结论上。
核心方法
挑选单位是话题：一件事从提出到讲完。一个观点和理由，一个问题与回答，一个故事和落点。一支短视频就是一个话题完整的一段，不多不少。避免两种错误做法：按长视频章节切（一章十分钟，开头铺垫三句才到点，结尾停在“接下来我们看”，还夹着两个话题）；只找金句凑时长（话题没讲完就断，观众听到结论却不明原因）。
主要能力
- 话题发现与筛选：读取带时间的转写文稿，按话题切分，记录起止、一句话概括和落点。合格话题须同时满足：有看点（反常识、情绪高点、密集干货、带转折的小故事）、单独成立（没有“刚才说的那个”“第二点”等指代）、有头有尾（能直接开场且讲到了落点）。
- 数量与时长控制：用户可指定支数（如“要 N 支”），自动模式则建成所有合格话题（超过 10 个只建最强 10 支，其余列候选）。每支时长可自动按话题定，或用户给范围（如 15–30 秒、1–3 分钟）；话题比范围长时取内部能单独成立、有落点的小点，装不下就放弃，不为凑时长带铺垫或砍理由。
- 边界精确到句子：入点取开头句第一个词与前一个词之间停顿的中点，出点取最后词与下一个词之间停顿的中点，不切进词里。开头3秒要有人说话，不加标题卡；开头有铺垫时挪到第一句能直接抓人的话；结尾停在落点上，遇到“关注订阅”则提前到上一句。
- 按镜头取景（自动）：先用
videos_shots分镜头，再用videos_frames取帧，基于人脸检测结果按镜头分别设定裁框。识别主讲人、采访者、全景，避开台标、水印、烧入字幕与边框。支持 9:16、1:1 或保留原画幅。 - 创建可编辑子视频：通过
videos_derive为每段创建独立子视频，保留完整时间线和文稿，用户可在编辑器中调整入出点、画面和字幕，需要文件时再导出。 - 访谈处理：优先一个人不被打断的整段，允许从回答的第一句完整句开始；采访者短插话可接受，但要在 notes 中说明。
- 警告如实转述：创建结果中的 warnings（如多素材、字幕未建、裁框被调整、译文未带等）逐条用大白话告诉用户。
使用方式
前提是视频已有转写（kind 为 speech 的文档）；没有时先转写并告知用户。然后导出带时间的字幕或文稿（purpose preview），读文稿找话题。用户点了话题时，先用 space_search_v2 搜索定位，再读前后文稿定区间。创建时调用 videos_derive，传入父视频、时间线秒的 start/end、名称、画幅、取景参数等。是否需要先给用户看候选取决于用户指令：有“找好就直接创建”则直接建；否则先列候选（含入出点、话题、开头原话、亮点、单独成立理由、发现的问题）等用户挑。创建后核对返回的 range 与 captions 的 cueCount。默认交付子视频，用户明确要文件时才导出 mp4。
适用场景
- 访谈、讲座、直播回放、口播等长视频中切出独立短视频。
- 用户已有明确话题想切某一段。
- 按指定数量或时长范围切出多支。
- 需要可编辑子视频后续调整，而非直接要成片文件。
限制
- 需要视频转写；没有转写时需先转写。
- 不用于从零制作新短视频，也不用于把整段口播剪干净（应使用剪口播）。
- 取景是按镜头的静态裁框，不是跟随人物的运动镜头；无法承诺画面一直跟着人移动。
- 自动定长超过 3 分钟时只提醒一句，YouTube 不按 Shorts 收，其余照做。
- 边界停下短于一帧时运行时会把边界收进停顿，返回的 range 可能与传入值差几帧，需核对。
- 父视频剪辑过时，文稿时间已是剪辑后时间；用户想按原素材切时需先确认版本。
- 某些 warnings 表示部分内容无法完全按预期处理（如区间外未能完全剪掉、字幕未建、译文未带），需如实告知用户。