AI MediaKit 的“高光智剪 \- 小游戏”工具，基于多模态视频理解，深度理解消除、闯关、竞技等各类小游戏玩法，自动从原始录屏中精准捕捉“全屏连击、BOSS 通关、极限操作”等高光瞬间，快速生成适用于买量推广、社区分享等场景的视频素材。您可以通过提供游戏名称、玩法描述、高光定义等信息，来辅助模型更精准地识别和剪辑精彩内容。本篇开发指南将引导您： * 快速体验从一个游戏录屏视频中，自动生成高光集锦。 * 学习如何通过提供游戏描述信息，来提升剪辑的精准度和效果。 * 了解该功能的工作原理与使用限制。 ## 效果预览通过“高光智剪 \- 小游戏”工具，您可以将一段原始的游戏录屏视频作为输入，快速生成一段剪辑好的高光集锦。 |输入的原始游戏录屏 |输出的高光视频 | |---|---| |

| ## 快速体验：生成一个基础的小游戏高光视频本节将演示如何从一个游戏录屏文件中，快速生成一个高光集锦。 ### 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备好一个小游戏录屏视频，并将其上传至公网可访问的服务器或视频点播服务中，以获取可供 API 调用的 URL。 ### 操作流程小游戏高光智剪是一个异步任务，完整流程如下： 1. 成功调用 `POST /api/v1/tools/generate-highlights-minigame` 提交任务后，您将获得一个任务 ID。 2. 您可以轮询 `GET /api/v1/tasks/{task_id}` 接口，直到任务状态`status` 变为 `completed`；或者使用[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可在 `video_urls` 数组中获取最终生成的视频文件下载地址。 #### 第 1 步：提交任务您需要调用[提交高光智剪（小游戏）任务 API](https://docs.volcengine.com/docs/6448/2386121)。可直接复制以下 cURL 命令，提交一个基础的高光剪辑任务。 ```bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/generate-highlights-minigame' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_urls": [ "https://example.com/your_gameplay_video.mp4" ], "mode": "HighlightExtract" }' ```

说明

参数替换说明：

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

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

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-generate-highlights-minigame-123456789", "request_id": "20240521160000ABCDEFG12345" } ``` #### 第 2 步：获取结果您需要通过轮询[查询任务信息 API](https://docs.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.video_urls` 数组中找到最终生成的混剪视频下载地址（默认有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-generate-highlights-minigame-123456789", "request_id": "20240521160000ABCDEFG12345", "status":"completed", "result": { "duration": 350.8, "video_urls": [ "https://example.volcvideo.com/game_highlight_1.mp4?auth_key=..." ], "mixvideo_info": [ { "mixvideo_index": 0, "video_url": "https://example.volcvideo.com/game_highlight_1.mp4?auth_key=...", "clips": [ { "clip_type": "HighlightClip", "score": 4.9, "source_video_index": 0, "source_start_time": 45.5, "source_end_time": 52.1, "cut_start_time": 0.0, "cut_end_time": 6.6 }, { "clip_type": "HighlightClip", "score": 4.7, "source_video_index": 0, "source_start_time": 180.2, "source_end_time": 188.9, "cut_start_time": 6.6, "cut_end_time": 15.3 } ] } ] }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851 } ``` ## 进阶使用 ### 提供游戏描述信息，提升剪辑精度为了让 AI 模型更懂您的游戏，从而更精准地识别出真正的“高光时刻”，建议您在提交任务时，通过 `minigame_info` 参数提供关于游戏的核心信息。 * `name`：游戏名称。 * `play_definition`：游戏的玩法、规则或核心特点描述。 * `highlight_definition`：您所认为的游戏高光时刻的定义描述（例如：“一次消除多个方块”、“躲避所有障碍物通关”、“触发了隐藏的彩蛋”等）。 #### 示例：为跑酷游戏提供描述信息 ```JSON { "video_urls": [ "https://example.com/parkour_gameplay.mp4" ], "mode": "HighlightExtract", "minigame_info": { "name": "极限跑酷达人", "play_definition": "玩家通过左右滑动控制角色，躲避障碍物并收集金币，最终到达终点。", "highlight_definition": "精彩瞬间包括：连续躲避多个快速移动的障碍物、吃到特殊加速道具、以第一名冲过终点线。" } } ``` ## 参考信息 ### 使用限制与性能 |限制项 |说明 | |---|---| |**输入视频限制** |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

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

* **数量限制**：单次任务仅支持输入 1 个视频文件。

* **时长限制**：输入文件时长不得超过 10 分钟。

* **分辨率限制**：最高支持 1080p。 | |**并发限制** |默认情况下，每个账户的并发处理任务数上限为 20。超出并发限制的新任务将自动进入队列等待。 | |**单视频处理耗时** |处理耗时和输入视频时长正相关。视频时长越长，处理耗时越长。平均 RTF（处理耗时/原片时长）为 1.5～2。 | ## 相关 API 文档 * [提交高光智剪（小游戏）任务 API](https://docs.volcengine.com/docs/6448/2386121) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)