AI MediaKit 的场景切分工具能够智能分析视频内容，依据镜头切换、转场效果和画面内容的变化，自动将一个长视频精准地切分为多个有意义的场景片段。该工具会输出每个片段的起止时间轴信息，并提供对应独立视频文件的下载地址，从而帮助您轻松实现视频拆条、集锦制作、关键帧提取等下游应用。本篇开发指南将引导您： * 理解场景切分的工作方式。 * 快速从一个视频中获取场景切分的时间码和独立视频文件。 * 学习如何调整切分粒度并获取独立的切片文件。 ## 效果预览通过场景切分工具，您可以实现以下效果： |输入的视频 |切分的视频 | |---|---| |

| ## 快速体验：获取视频场景时间轴与切片文件本节将通过一个具体的示例，演示如何为一个视频文件进行场景切分，并获取所有场景片段的起止时间戳与独立视频文件。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备一个待处理的视频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程场景切分是一个异步任务，整体流程如下： 1. 成功调用 `POST /api/v1/tools/segment-scenes` 提交任务后，您将获得一个唯一的 `task_id`。 2. 您可以轮询[查询任务信息 API](https://www.volcengine.com/docs/6448/2278532)，直到任务状态 `status` 变为 `completed`；或者使用[事件回调](https://www.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可在 `segments` 数组中获取所有场景片段的信息。 #### 第 1 步：提交任务调用[提交场景切分任务 API](https://www.volcengine.com/docs/6448/2386118)。您可以直接复制以下 cURL 命令，向 API 提交一个基本的场景切分任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/segment-scenes' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_long_video.mp4" }' ```

说明

需替换参数：

将 {Your_API_Key} 替换为您的有效 API Key。

将 video_url 的值替换为您自己准备的视频文件 URL。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-segment-scenes-123456789", "request_id": "20240521130000ABCDEFG12345" } ``` #### 第 2 步：获取结果由于视频处理需要时间，您需要通过轮询[查询任务信息 API](https://www.volcengine.com/docs/6448/2278532)来获取最终结果，直到任务状态变为 `completed`。 ```Bash curl -X GET 'https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}' \ -H 'Authorization: Bearer {Your_API_Key}' ```

说明

需替换参数：将 URL 末尾的 {task_id} 替换为第 1 步返回的任务 ID。

当任务成功完成后，您将收到如下响应。`result` 字段中的 `segments` 数组包含了所有切片的时间轴信息和独立视频文件下载地址。 ```JSON { "success": true, "task_id": "amk-tool-segment-scenes-123456789", "status": "completed", "result": { "duration": 185.5, "segments": [ { "start_time": 0.0, "end_time": 15.2, "segment_video_url": "https://example.com/clip_1.mp4" }, { "start_time": 15.2, "end_time": 45.8, "segment_video_url": "https://example.com/clip_2.mp4" }, { "start_time": 45.8, "end_time": 185.5, "segment_video_url": "https://example.com/clip_3.mp4" } ] }, ... } ``` ## 进阶使用 ### 调整切分粒度您可以通过 `segment_threshold`、`min_duration`、`max_duration` 和 `enable_clip_fade` 等参数，来精细化地控制场景切分的效果。 * `segment_threshold`：场景切分的敏感度阈值，范围为 [0, 100]。推荐的经验值为 `10`。 * **值越低，切分得越细碎**：算法对画面的变化更敏感，可能将细微的变化也识别为切分点。 * **值越高，切分得越粗略**：算法会忽略一些不那么显著的场景变化。 * `min_duration`：单个切片的**最小时长**（秒）。任何小于此时长的片段都将被自动合并到相邻的片段中。 * `max_duration`：单个切片的**最大时长**（秒）。任何大于此时长的片段都将被强制切分。 * `enable_clip_fade`：是否将检测到的淡入/淡出片段作为独立的切片输出。默认为 `false`。以下是一个示例请求，展示了如何使用这些参数来定制您的场景切分任务： ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/segment-scenes' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_long_video.mp4", "segment_threshold": 15, "min_duration": 2.5, "max_duration": 30, "enable_clip_fade": true }' ``` 在这个示例中，API 将会： * 使用 15 的敏感度进行切分。 * 确保每个生成的视频切片时长至少为 2.5 秒。 * 如果某个场景持续时间超过 30 秒，会将其强制切分。 * 将视频中的淡入/淡出效果识别为独立的片段进行输出。 ## 参考信息 ### 使用限制与性能 |限制项 |说明 | |---|---| |**输入文件限制** |* **文件来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://www.volcengine.com/docs/6448/2536893)。

* **支持格式**：`mp4`, `flv`, `ts`, `avi`, `mov`, `wmv`, `mkv` 等主流视频格式。

* **视频时长**：单个视频时长不超过 2 小时。 | ## 相关 API 文档 * [提交场景切分任务 API](https://www.volcengine.com/docs/6448/2386118) * [查询任务信息 API](https://www.volcengine.com/docs/6448/2278532) * [事件回调](https://www.volcengine.com/docs/6448/2288701)