AI MediaKit 的高光片段提取工具，并非直接剪辑视频，而是作为一个智能分析引擎，深度理解您的视频内容。它能精准捕捉视频中的“情绪高潮”、“关键动作”或“高能瞬间”，并以结构化数据（JSON）的形式，输出包含精确时间戳、高光分数、OCR 文本和画面描述的详细元数据。本篇开发指南将引导您： * 快速体验从视频中提取一份完整的高光元数据。 * 了解如何针对“短剧”和“小游戏”两种不同场景，使用对应的分析模型。 * 学习如何通过提供辅助信息，提升小游戏场景的分析精准度。 ## 快速体验：提取小游戏视频的高光数据本节将以“小游戏”场景为例，演示如何从一个游戏录屏中，快速提取出高光时刻的元数据。 ### 准备工作 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`；或者使用[事件回调](/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可获取完整的高光分析元数据。 #### 第 1 步：提交任务您需要调用[提交高光片段提取任务 API](/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/game_play_video.mp4" ], "model": "Game", "mode": "HighlightExtract", "minigame_info": { "name": "方块消除大师", "play_definition": "通过交换相邻方块，使三个或以上同色方块连成一线以消除得分。", "highlight_definition": "高光时刻包括一次性消除五块以上、触发连锁消除反应、使用特殊道具清屏等。" } }' ``` :::tip * 将 `{Your_API_Key}` 替换为您的有效 API Key。 * 将 `video_urls` 列表中的 URL 替换为您真实的录屏视频地址。 * 在 `minigame_info` 中提供关于游戏的描述，可以显著提升分析的准确性。 ::: 请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-analyze-video-highlights-123456789", "request_id": "20240522100000ABCDEFG12345" } ``` #### 第 2 步：获取结果您需要通过轮询[查询任务信息 API](/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}' ``` :::tip **需替换参数**：将 URL 末尾的 `{task_id}` 替换为第 1 步返回的任务 ID。 ::: 当任务成功完成后，您将收到如下响应。所有的高光分析数据都在 `result` 字段中。 ```JSON { "success": true, "task_id": "amk-tool-analyze-video-highlights-123456789", "request_id": "20240522100000ABCDEFG12345", "status": "completed", "result": { "duration": 155.0, "highlight_info": [ { "source_video_index": 0, "start_time": 45.2, "end_time": 48.9, "score": 4.8, "ocr": "超级连击！", "description": "游戏画面中，大量方块被同时消除，触发了华丽的特效。" }, { "source_video_index": 0, "start_time": 121.0, "end_time": 124.5, "score": 4.5, "ocr": "新纪录诞生！", "description": "游戏结算界面，显示了破纪录的得分数字。" } ] }, "expires_at": 1777531298, "created_at": 1777358413, "finished_at": 1777358499 } ``` ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |**通用限制** |* **视频来源**：仅支持公网可访问的 HTTP/HTTPS URL。|\ | |* **支持格式**：`mp4`, `flv`, `ts`, `avi`, `mov`, `wmv`, `mkv` 等主流视频格式。|\ | |* **输入分辨率限制**：最高支持 1080p。 | |**短剧模型限制** (`model: "Miniseries"`) |* **输入配额**：单次任务最多支持输入 **20** 个视频文件，累计总时长建议不超过 **45** 分钟。|\ | |* **输入素材要求**：必须同时包含视频流和音频流。|\ | | * **视频画面要求**：视频画面下半部分（垂直位置 0.5\-1.0 范围内）必须包含清晰居中的中文字幕。|\ | | * **音频流要求**：视频的音频轨道中必须包含清晰可识别的中文对话文本。仅包含 BGM（含歌词）、纯音乐、语气词或无有效语义的声音，将无法准确识别剧情逻辑。 | |**小游戏模型限制** (`model: "Game"`) |* **数量限制**：当前单次任务仅支持输入**单个**视频文件。如果输入多个视频，会默认选择第一个文件进行分析。|\ | |* **时长限制**：输入文件的时长不得超过 10 分钟。 | ## 相关 API 文档 * [提交高光片段提取任务 API](/docs/6448/2386119) * [查询任务信息 API](/docs/6448/2278532) * [事件回调](/docs/6448/2288701)

智能处理