AI MediaKit 的“高光智剪\-短剧”工具，能够深度理解输入剧集的角色关系与故事脉络，并结合您设定的剪辑要求（如时长、数量、剪辑手法等），自动生成高光混剪、单集预告等多种形式的营销短视频。该工具旨在将繁琐的剪辑工作流自动化，助您快速、批量地生产高质量的短剧推广素材。本篇开发指南将引导您： * 快速体验从多集短剧中生成一个高光混剪视频。 * 理解如何通过各项参数，精细化地控制成片的剪辑逻辑与视觉风格。 * 了解该功能的工作原理与使用限制。 ## 效果预览通过“高光智剪\-短剧”工具，您可以将一组短剧视频作为输入，快速生成符合营销需求的混剪视频。 |输入 3 集短剧视频 |输出的高光混剪视频 | |---|---| |

|一个 2 分不到的高光混剪，包含开场钩子、剧名、角标和提示语等视觉元素。

| ## 快速体验：生成一个带“三要素”的短剧高光混剪视频本节将演示如何从几集短剧中，快速生成一个包含“剧名”和“提示语”视觉元素的混剪视频。 ### 准备工作 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/generate-highlights-microdrama` 提交任务后，您将获得一个任务 ID。 2. 您可以轮询 `GET /api/v1/tasks/{task_id}` 接口，直到任务状态`status` 变为 `completed`；或者使用[事件回调](https://www.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可在 `video_urls` 数组中获取最终生成的视频文件下载地址。 #### 第 1 步：提交任务您需要调用[提交高光智剪（短剧）任务 API](https://www.volcengine.com/docs/6448/2386120)。可直接复制以下 cURL 命令，提交一个包含基础视觉包装的剪辑任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/generate-highlights-microdrama' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_urls": [ "https://example.com/miniseries_ep01.mp4", "https://example.com/miniseries_ep02.mp4", "https://example.com/miniseries_ep03.mp4" ], "mode": "StorylineCuts", "edit_param": { "mode": "TemplateEdit", "template_edit": { "template": "热门短剧1", "title": "我的霸总男友", "hint": "点击下方看完整版" } } }' ```

说明

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

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

您可以修改 title 和 hint 的内容来自定义成片中的文字。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-generate-highlights-microdrama-123456789", "request_id": "20240521150000ABCDEFG12345" } ``` #### 第 2 步：获取结果您需要通过轮询查询任务接口，直到任务状态 `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-microdrama-123456789", "request_id": "20240521150000ABCDEFG12345", "status": "completed", "result": { "duration": 2450.5, "video_urls": [ "https://example.volcvideo.com/highlight_output_1.mp4?auth_key=..." ], "mixvideo_info": [ { "mixvideo_index": 0, "video_url": "https://example.volcvideo.com/highlight_output_1.mp4?auth_key=...", "clips": [ { "clip_type": "OpeningHook", "score": 4.8, "source_video_index": 1, "source_start_time": 305.2, "source_end_time": 310.7, "cut_start_time": 0.0, "cut_end_time": 5.5 }, { "clip_type": "HighlightClip", "score": 4.5, "source_video_index": 0, "source_start_time": 120.1, "source_end_time": 128.3, "cut_start_time": 5.5, "cut_end_time": 13.7 } ] } ] }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851 } ``` ## 进阶使用 ### 使用“短剧三要素”视觉模板短剧三要素”是经过市场验证的、能有效提升营销视频吸引力的三种关键视觉元素： * **短剧名**：在画面上展示剧名，用于品牌识别和引导用户搜索。 * **角标**：通常位于角落，带有“热门短剧”、“爆款推荐”等文字的标签，用于营造“这部剧很受欢迎，值得一看”的心理暗示，吸引用户点击。 * **提示语**：画面左右两侧的一行文字，可以是概括视频核心冲突或亮点的引导性文字，也可以是类似“影视效果请勿模仿无不良价值观引导”的免责声明。上文“快速体验”的示例中使用了 `"热门短剧1"` 视觉模板。AI MediaKit 提供以下 5 个预设的视觉模板，您可以根据视频内容或投放渠道的风格，选择不同的模板来改变“短剧三要素”的呈现样式。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/7dff54f4edff4884afc2b60c006e75e4) #### **示例：使用**`"热门短剧2"` 视觉模板并**添加剧名和提示语** ```JSON { "edit_param": { "mode": "TemplateEdit", "template_edit": { "template": "热门短剧2", "title": "败给月光", "hint": "影视演艺切勿当真" } } } ``` ### 顺剪与混剪默认情况下，高光智剪工具采用 `Mixed` 混剪模式，即打乱原始视频片段的时序，以达到最佳的戏剧冲突效果。如果您希望剪辑出的视频能基本保持原始剧情的时间顺序（仅去除片头片尾等非正片内容），可以通过 `highlight_cuts_param` 中的 `cut_mode` 参数，将剪辑模式设置为 `Sequential`（顺剪）。 * **顺剪 ** `Sequential`：高光片段将严格按照其在原片中的时间顺序进行排列。这种模式适合制作分集回顾或剧情概述。 * **混剪**`Mixed`：系统会根据每个片段的“精彩程度”评分进行重新排序，将最吸引人的内容放在更靠前的位置，以增强视频的观赏性和传播力。这种模式更适合制作营销预告片或高光集锦。 #### 示例：将剪辑模式设置为顺剪 ```json { "highlight_cuts_param": { "cut_mode": "Sequential" } } ``` ### 开启/关闭智能精彩前置（开场钩子）默认情况下，系统会将视频中最精彩的片段前置到素材片头，以快速抓住用户眼球。如果您不希望在成片中包含这个开场钩子，可以通过 `opening_hook_param` 参数将其关闭。 #### **示例：关闭开场钩子功能** ```json { "opening_hook_param": { "enable_opening_hook": false } } ``` ### 获取详细分镜信息（Storyboard）默认情况下，API 的响应结果中不包含详细的分镜构成信息。如果您需要了解最终生成的混剪视频具体由哪些原始片段构成，可以通过 `highlight_cuts_param` 中的 `enable_storyboard` 参数来获取。开启后，API 的返回结果中将增加 `result.storyboard_info` 字段，其中包含一个详细的分镜列表（Storyboard），列出了每个分镜片段的来源（`source_video_index`）、在原片中的起止时间（`start_time`, `end_time`）、高光分数、OCR 字幕文本等信息。 #### **示例：在任务结果中请求分镜信息** ```json { "highlight_cuts_param": { "enable_storyboard": true } } ``` ## 参考信息 ### 使用限制与性能 |限制项 |说明 | |---|---| |**输入视频限制** |* 视频来源：仅支持公网可访问的 HTTP/HTTPS URL。

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

* 数量限制：单次任务最多支持传入 30 个视频文件。

* 累计时长：所有输入文件的累计总时长不得超过 45 分钟。

* 输入分辨率限制：最高支持 1080p。

* 输入素材要求：必须同时包含视频流和音频流，且画面下半部分需包含清晰居中的中文字幕，音频中需包含清晰的中文对话。 | |**并发限制** |单次任务中输入多个视频时，默认同时执行任务数将会减少，单任务处理视频数量 ✖️ 同时执行任务数 ≤ 20，超出并发限制的新任务将自动进入队列等待。单任务输入视频数量越多，处理耗时 RTF 会相应降低，参考如下：

* 输入 1 个视频：处理耗时是源视频时长 5 倍，默认同时执行任务数 20 个

* 输入 3 个视频：耗时是源视频时长 2 倍，默认同时执行任务数 6 个

* 输入 10 个视频：耗时是源视频时长的 0.9 倍，默认同时执行任务数 2 个 | ### 参数配置最佳实践为了帮助您高效生成用于广告投放的高转化率素材，我们根据短剧行业的投放经验，提供以下参数配置最佳实践： * **输入视频**：建议选取短剧的**前 10\-20 集免费剧集**作为高光分析的输入源。这些剧集是吸引新用户的关键，将其中的强冲突、高能反转片段进行混剪，能有效提升广告素材的点击和转化率。 * **目标生成时长**：广告投放素材通常有固定的时长范围。您可以通过 `MinDuration` 和 `MaxDuration` 参数来控制生成的高光集锦总时长： * **1\-3 分钟素材**：设置 `MinDuration` 为 60，`MaxDuration` 为 180。 * **3\-5 分钟素材**：设置 `MinDuration` 为 180，`MaxDuration` 为 300。 * **5\-7 分钟素材**：设置 `MinDuration` 为 300，`MaxDuration` 为 420。 * **智能精彩前置**：建议开启智能精彩前置功能，并使用系统默认配置。系统默认会将视频中最精彩的 5\-15 秒片段前置到素材片头，且前置片段本身也由不短于 5 秒的子片段构成。这一配置旨在快速抓住用户眼球，是提升广告转化率的有效手段。 ## 相关 API 文档 * [提交高光智剪（短剧）任务 API](https://www.volcengine.com/docs/6448/2386120) * [查询任务信息 API](https://www.volcengine.com/docs/6448/2278532) * [事件回调](https://www.volcengine.com/docs/6448/2288701)

智能处理