blitzreels-clipping

BlitzReels 剪辑

使用托管剪辑状态机。 它负责管理导入、转录、选择、布局、字幕、QA、修复和导出的顺序。

步骤

1. 将源解析为受支持的公开视频 URL 或工作区资产 ID，并解析选择意图。 使用提供的时间范围或建议；仅在选择权交由系统时，才使用自动最佳选择。 源和选择模式均明确后，此步骤完成。
2. 选择可用界面。优先使用捆绑的 MCP clips_create 工具；否则，通过 blitzreels agent-context --command "clips create" --json 或 OpenAPI /clips 操作查询当前契约。 确认所需输入、变更效果和状态字段后，此步骤完成。
3. 使用调用方生成的幂等键创建剪辑。 响应包含剪辑 ID、项目 ID、状态和 next_action 后，此步骤完成。
4. 对于 MCP 批次，按照 batch.polling 使用 clips_get。对于托管 API 剪辑，按照 next_action 进行轮询、重新选择、修复、导出或停止。 仅当后续响应推进了状态或到达终止状态时，才算完成每次状态转换。
5. 如果用户保留了选择权，展示可用的备选项及其标题、钩子、范围、时长和评分；然后重新选择已批准的 ID 或范围。 所选内容已持久化后，此步骤完成。
6. 验证布局意图。 教程布局适用于已合并的屏幕共享和人脸摄像头素材。 访谈和播客素材使用自动、分屏或聚焦布局。 应用的布局与内容类型一致后，此步骤完成。
7. 查看 QA 预览和警告；仅执行当前状态提供的修复操作。 QA 通过或状态报告了明确的未解决阻塞项后，此步骤完成。
8. 仅在用户批准且状态为可导出时，开始付费导出。 轮询至终止状态，并验证输出时长、宽高比、字幕、画面构图和下载位置。

手动分支

仅当托管状态报告了需要手动控制的特定阻塞项时，才使用低级项目媒体、转录文本、时间线、字幕和预览操作。

修复后返回托管剪辑，不要通过低级调用重建其状态机。

完成

返回剪辑和项目 ID、所选范围、应用的布局、QA 结果、警告、导出状态和下载位置。

如果受阻，返回 next_action、确切的阻塞状态，以及所需的用户选择或系统状态。 只有经验证的终止输出或明确的托管状态阻塞项，才算完成。