文档中心

AI MediaKit

视频工具

场景切分

AI MediaKit 的场景切分工具能够智能分析视频内容，依据镜头切换、转场效果和画面内容的变化，自动将一个长视频精准地切分为多个有意义的场景片段。该工具会输出每个片段的起止时间轴信息，并提供对应独立视频文件的下载地址，从而帮助您轻松实现视频拆条、集锦制作、关键帧提取等下游应用。

本篇开发指南将引导您：

理解场景切分的工作方式。

快速从一个视频中获取场景切分的时间码和独立视频文件。

学习如何调整切分粒度并获取独立的切片文件。

效果预览

通过场景切分工具，您可以实现以下效果：

输入的视频	切分的视频
Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

快速体验：获取视频场景时间轴与切片文件

本节将通过一个具体的示例，演示如何为一个视频文件进行场景切分，并获取所有场景片段的起止时间戳与独立视频文件。

准备工作

获取访问凭证：在开始之前，访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 MediaKit API Key（用于媒体处理功能鉴权）。

准备视频文件：准备一个待处理的视频文件，并将其上传至公网可访问的服务器或视频点播服务中，以获取可供 API 调用的 URL。

操作流程

场景切分是一个异步任务，整体流程如下：

成功调用 POST /api/v1/tools/segment-scenes 提交任务后，您将获得一个唯一的 task_id。

您可以轮询查询任务信息 API，直到任务状态 status 变为 completed；或者使用事件回调自动接收任务状态变化。

任务完成后，解析响应中的 result 字段，即可在 segments 数组中获取所有场景片段的信息。

第 1 步：提交任务

调用提交场景切分任务 API。您可以直接复制以下 cURL 命令，向 API 提交一个基本的场景切分任务。

说明

需替换参数：

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

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

请求成功后，您会收到如下包含 task_id 的响应，请保存此 ID 用于后续查询。

第 2 步：获取结果

由于视频处理需要时间，您需要通过轮询查询任务信息 API来获取最终结果，直到任务状态变为 completed。

说明

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

当任务成功完成后，您将收到如下响应。result 字段中的 segments 数组包含了所有切片的时间轴信息和独立视频文件下载地址。

进阶使用

调整切分粒度

您可以通过 segment_threshold、min_duration、max_duration 和 enable_clip_fade 等参数，来精细化地控制场景切分的效果。

segment_threshold：场景切分的敏感度阈值，范围为 [0, 100]。推荐的经验值为 10。

值越低，切分得越细碎：算法对画面的变化更敏感，可能将细微的变化也识别为切分点。

值越高，切分得越粗略：算法会忽略一些不那么显著的场景变化。

min_duration：单个切片的最小时长（秒）。任何小于此时长的片段都将被自动合并到相邻的片段中。

max_duration：单个切片的最大时长（秒）。任何大于此时长的片段都将被强制切分。

enable_clip_fade：是否将检测到的淡入/淡出片段作为独立的切片输出。默认为 false。

以下是一个示例请求，展示了如何使用这些参数来定制您的场景切分任务：

在这个示例中，API 将会：

使用 15 的敏感度进行切分。

确保每个生成的视频切片时长至少为 2.5 秒。

如果某个场景持续时间超过 30 秒，会将其强制切分。

将视频中的淡入/淡出效果识别为独立的片段进行输出。

参考信息

使用限制与性能

限制项	说明
输入文件限制	文件来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。支持格式：mp4, flv, ts, avi, mov, wmv, mkv 等主流视频格式。视频时长：单个视频时长不超过 2 小时。