AI MediaKit 的高光片段提取工具，并非直接剪辑视频，而是作为一个智能分析引擎，深度理解您的视频内容。它能精准捕捉视频中的“情绪高潮”、“关键动作”或“高能瞬间”，并以结构化数据（JSON）的形式，输出包含精确时间戳、高光分数、OCR 文本和画面描述的详细元数据。本篇开发指南将引导您： * 快速体验从视频中提取一份完整的高光元数据。 * 了解如何针对“短剧”和“小游戏”两种不同场景，使用对应的分析模型。 * 学习如何通过提供辅助信息，提升小游戏场景的分析精准度。 ## 效果预览通过高光片段提取工具，您可以将一组短剧视频作为输入，快速提取高光信息。 |输入 3 集短剧视频 |输出的高光片段信息示例 | |---|---| |

|```JSON```
```[```
``` {```
``` "source_video_index": 0,```
``` "start_time": 95.84,```
``` "end_time": 107.64,```
``` "score": 3.5,```
``` "ocr": "不出意外的话，李山峰怕是裤衩子都要亏没喽...",```
``` "description": "主角预见投资失败的严重后果，产生帮助他人的动机。"```
``` },```
``` {```
``` "source_video_index": 2,```
``` "start_time": 34.68,```
``` "end_time": 48.6,```
``` "score": 4.0,```
``` "ocr": "这是我跟你哥所有的积蓄，要有什么损失，我跟你没完！",```
``` "description": "因投资问题，家庭内部爆发激烈争吵，戏剧冲突升级。"```
``` }```
```]```
| ## 快速体验：提取短剧视频的高光数据本节将以“短剧”场景为例，演示如何从多个视频片段中，快速提取出包含剧情高光的元数据。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备好多个短剧视频片段，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程高光片段提取是一个异步任务，完整流程如下： 1. 成功调用 `POST /api/v1/tools/analyze-video-highlights` 提交分析任务后，您将获得一个任务 ID。 2. 您可以轮询 `GET /api/v1/tasks/{task_id}` 接口，直到任务状态`status` 变为 `completed`；或者使用[事件回调](https://www.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可获取完整的高光分析元数据。 #### 第 1 步：提交任务您需要调用[提交高光片段提取任务 API](https://www.volcengine.com/docs/6448/2386119)。可直接复制以下 cURL 命令，提交一个针对短剧视频的分析任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/analyze-video-highlights' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_urls": [ "https://example.com/miniseries_part1.mp4", "https://example.com/miniseries_part2.mp4", "https://example.com/miniseries_part3.mp4" ], "model": "Miniseries", "mode": "StorylineCuts" }' ```

说明

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

将 video_urls 列表中的 URL 替换为您真实的短剧视频地址。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-analyze-video-highlights-123456789", "request_id": "20240522100000ABCDEFG12345" } ``` #### 第 2 步：获取结果您需要通过轮询[查询任务信息 API](https://www.volcengine.com/docs/6448/2278532)，直到任务状态 `status` 变为 `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` 字段中。 ```JSON { "success": true, "task_id": "amk-tool-analyze-video-highlights-102762921730", "request_id": "20260507145242FCF48EE1F61E7DB775F1", "status": "completed", "result": { "duration": 342.38, "highlight_info": [ { "source_video_index": 0, "start_time": 81.12, "end_time": 95.84, "score": 3.5, "ocr": "所谓的股票老师...背后就是个空壳公司，妥妥的垃圾，买了就是送钱。", "description": "主角揭露“内部消息”股票实为空壳公司的骗局。" }, { "source_video_index": 1, "start_time": 3.08, "end_time": 7.84, "score": 3.0, "ocr": "谁让你乱动舅舅电脑的，这里面数字都是真金白银！", "description": "家人发现电脑被动用，强调其内含重要资产，引发紧张气氛。" }, { "source_video_index": 2, "start_time": 34.68, "end_time": 48.6, "score": 4.0, "ocr": "这是我跟你哥所有的积蓄，要有什么损失，我跟你没完！", "description": "因投资问题，家庭内部爆发激烈争吵，戏剧冲突达到高潮。" }, { "source_video_index": 2, "start_time": 68.84, "end_time": 75.16, "score": 4.0, "ocr": "不行，你不能卖！...小兔崽子，你小学都没毕业，你懂什么呀你！", "description": "少年阻止卖出股票，与长辈发生观念冲突，形成鲜明对比。" } ] }, "expires_at": 1778310069, "created_at": 1778136763, "finished_at": 1778137269 } ``` ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |**通用限制** |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://www.volcengine.com/docs/6448/2536893)。

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

* **输入分辨率限制**：最高支持 1080p。 | |**短剧模型限制** (`model: "Miniseries"`) |* **输入配额**：单次任务最多支持输入 30 个视频文件，累计总时长建议不超过 45 分钟。

* **输入素材要求**：必须同时包含视频流和音频流。

* **视频画面要求**：视频画面下半部分（垂直位置 0.5\-1.0 范围内）必须包含清晰居中的中文字幕。

* **音频流要求**：视频的音频轨道中必须包含清晰可识别的中文对话文本。仅包含 BGM（含歌词）、纯音乐、语气词或无有效语义的声音，将无法准确识别剧情逻辑。 | |**小游戏模型限制** (`model: "Game"`) |* **数量限制**：当前单次任务仅支持输入 1 个视频文件。如果输入多个视频，会默认选择第一个文件进行分析。

* **时长限制**：输入文件的时长不得超过 10 分钟。 | ## 相关 API 文档 * [提交高光片段提取任务 API](https://www.volcengine.com/docs/6448/2386119) * [查询任务信息 API](https://www.volcengine.com/docs/6448/2278532) * [事件回调](https://www.volcengine.com/docs/6448/2288701)