文档中心

AI MediaKit

视频工具

高光智剪-短剧

AI MediaKit 的“高光智剪-短剧”工具，能够深度理解输入剧集的角色关系与故事脉络，并结合您设定的剪辑要求（如时长、数量、剪辑手法等），自动生成高光混剪、单集预告等多种形式的营销短视频。该工具旨在将繁琐的剪辑工作流自动化，助您快速、批量地生产高质量的短剧推广素材。

本篇开发指南将引导您：

快速体验从多集短剧中生成一个高光混剪视频。

理解如何通过各项参数，精细化地控制成片的剪辑逻辑与视觉风格。

了解该功能的工作原理与使用限制。

效果预览

通过“高光智剪-短剧”工具，您可以将一组短剧视频作为输入，快速生成符合营销需求的混剪视频。

输入 3 集短剧视频	输出的高光混剪视频
Replay Play 00:00 / 03:04 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 01:29 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag Replay Play 00:00 / 01:09 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	一个 2 分不到的高光混剪，包含开场钩子、剧名、角标和提示语等视觉元素。 Replay Play 00:00 / 01:45 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

快速体验：生成一个带“三要素”的短剧高光混剪视频

本节将演示如何从几集短剧中，快速生成一个包含“剧名”、“角标”、“提示语”视觉元素的混剪视频。

准备工作

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

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

操作流程

短剧高光智剪是一个异步任务，完整流程如下：

成功调用 POST /api/v1/tools/generate-highlights-microdrama 提交任务后，您将获得一个任务 ID。

您可以轮询 GET /api/v1/tasks/{task_id} 接口，直到任务状态status 变为 completed；或者使用事件回调自动接收任务状态变化。

任务完成后，解析响应中的 result 字段，即可在 video_urls 数组中获取最终生成的视频文件下载地址。

第 1 步：提交任务

您需要调用提交高光智剪（短剧）任务 API。可直接复制以下 cURL 命令，提交一个包含基础视觉包装的剪辑任务。

说明

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

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

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

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

第 2 步：获取结果

您需要通过轮询查询任务接口，直到任务状态 status 变为 completed。

说明

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

当任务成功完成后，您将收到如下响应。您可以在 result.video_urls 数组中找到最终生成的混剪视频下载地址（默认有效期为 24 小时）。

进阶使用

使用短剧三要素视觉模板

短剧三要素是经过市场验证的、能有效提升营销视频吸引力的三种关键视觉元素：

短剧名：在画面上展示剧名，用于品牌识别和引导用户搜索。

角标：通常位于角落，带有“热门短剧”、“爆款推荐”等文字的标签，用于营造“这部剧很受欢迎，值得一看”的心理暗示，吸引用户点击。

提示语：画面左右两侧的一行文字，可以是概括视频核心冲突或亮点的引导性文字，也可以是类似“影视效果请勿模仿无不良价值观引导”的免责声明。

上文“快速体验”的示例中使用了 “热门短剧1” 视觉模板。AI MediaKit 提供以下 5 个预设的视觉模板，您可以根据视频内容或投放渠道的风格，选择不同的模板来改变短剧三要素的呈现样式。

亮点

为避免剧名与视频内嵌字幕重叠，AI MediaKit 支持剧名智能防遮挡。在使用 1、2、4、5 号模板时，系统会自动检测字幕区域，并将剧名动态调整至无遮挡的安全位置，确保视觉效果清晰、专业。

示例：使用 “热门短剧2” 视觉模板并添加剧名和提示语

顺剪与混剪

默认情况下，高光智剪工具采用 Mixed 混剪模式，即打乱原始视频片段的时序，以达到最佳的戏剧冲突效果。如果您希望剪辑出的视频能基本保持原始剧情的时间顺序（仅去除片头片尾等非正片内容），可以通过 highlight_cuts_param 中的 cut_mode 参数，将剪辑模式设置为 Sequential（顺剪）。

顺剪（Sequential）：高光片段将严格按照其在原片中的时间顺序进行排列。这种模式适合制作分集回顾或剧情概述。

混剪（Mixed）：系统会根据每个片段的“精彩程度”评分进行重新排序，将最吸引人的内容放在更靠前的位置，以增强视频的观赏性和传播力。这种模式更适合制作营销预告片或高光集锦。

示例：将剪辑模式设置为顺剪

精细化引导混剪模式的高光选取

在混剪（cut_mode 为 Mixed）模式下，除了依赖算法的自动选择，您还可以通过提交结构化的自然语言指令（Prompt）和指定优先片段，来更精细地引导系统选取您期望的高光片段、开头和结尾，以生成更符合您运营策略的混剪视频。您可以通过 highlight_cuts_param 对象中的以下参数实现：

highlight_segment_prompt：定义高光片段的整体筛选标准。

highlight_start_prompt：定义混剪视频的开场片段应具备哪些特征。

highlight_ending_prompt：定义混剪视频的结尾片段应具备哪些特征。

user_preferred_segments：强制或优先选用您指定的某几集或某个时间段的片段。

示例 1：定义高光片段的整体风格

highlight_segment_prompt 可用于指导算法在筛选所有高光片段时的总体偏好。为提升效果，强烈建议您在编写 Prompt 时遵循以下结构，并包含“优先选择”、“内容要求”、“节奏要求”这些关键词。

API 请求示例：

示例 2：自定义开头

highlight_start_prompt 可用于从所有备选的高光片段中，挑选出最适合作为混剪视频开头的“钩子”（Hook），目标是在最初几秒内迅速抓住观众。为提升效果，强烈建议您在编写 Prompt 时遵循以下结构，并包含“目标”、“优先选择”、“规避”、“形式”这些关键词。

API 请求示例：

示例 3：自定义结尾

highlight_ending_prompt 可用于指导算法选择混剪视频的收尾片段，目标是留下强烈的情绪余韵或悬念，引导观众期待后续或点击转化。为提升效果，强烈建议您在编写 Prompt 时遵循以下结构，并包含“目标”、“优先选择”、“规避”、“形式”这些关键词。

API 请求示例：

示例 4：指定优先片段

如果您希望将某些特定片段（例如，运营中总结出的高转化率“卡点集”）优先用于混剪，可使用 user_preferred_segments 参数。适用场景：

整集优先：例如第四集是全剧核心转折，希望多采用该集素材。

片段优先：例如第二集结尾的 5 分钟打斗场面非常精彩，希望优先选用。

以下示例表示，算法在选择高光片段时，会优先考虑使用第 4 集（索引为 3）的全部内容，以及第 2 集（索引为 1）中 300 秒至 600 秒的片段。

智能精彩前置（开场钩子）

智能精彩前置（也称为“开场钩子”）功能，旨在从所有高光片段中自动挑选极具吸引力的片段，置于混剪视频的开头，以实现“黄金三秒”快速留住观众的目的。该功能通过请求体中的 opening_hook_param 对象进行控制。智能精彩前置功能是默认开启的。您也可以通过 opening_hook_param 内的 enable_opening_hook 参数来显式开启或关闭此功能。

"enable_opening_hook": true：（默认值）启用智能精彩前置。

"enable_opening_hook": false：禁用智能精彩前置，视频将直接从正片高光片段开始。

除了基础的开关，您还可以通过以下参数对开场钩子的筛选条件进行精细化控制：

参数	描述
min_duration max_duration	控制开场钩子片段的总时长范围，默认为 5-15 秒。
min_clip_duration	构成钩子的单个高光片段的最小持续时长，默认为 5 秒。
min_score	构成钩子的单个高光片段所需达到的最低高光分，范围 [1, 5]，默认为 3。
opening_hook_prompt	使用自然语言描述您偏好的钩子筛选标准。

示例：通过 opening_hook_prompt 精细化引导钩子选取

当您希望开场钩子符合特定风格（如强冲突、强悬念、强情绪）时，可以使用 opening_hook_prompt 参数来向算法提供明确、具体的指引。Prompt 越具体，选出的钩子越精准。Prompt 编写参考：

以下示例演示了如何要求系统优先选择包含“身份揭露”或“掌掴”场景的片段作为开场钩子：

获取详细分镜信息（Storyboard）

默认情况下，API 的响应结果中不包含详细的分镜构成信息。如果您需要了解最终生成的混剪视频具体由哪些原始片段构成，可以通过 highlight_cuts_param 中的 enable_storyboard 参数来获取。开启后，API 的返回结果中将增加 result.storyboard_info 字段，其中包含一个详细的分镜列表（Storyboard），列出了每个分镜片段的来源（source_video_index）、在原片中的起止时间（start_time, end_time）、高光分数、OCR 字幕文本等信息。

示例：在任务结果中请求分镜信息

参考信息

计费说明

高光智剪工具的费用基于输入视频总时长与输出视频总时长混合累计计算。关于详细的计费规则、换算系数和计费示例，请参阅高光智剪（输入 + 输出混合计费）。

使用限制

限制项	说明
输入视频限制	视频来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。支持格式：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 秒的子片段构成。这一配置旨在快速抓住用户眼球，是提升广告转化率的有效手段。

Prompt 模板参考

为了帮助您更高效地生成符合特定叙事风格和情绪的混剪视频，提供以下可直接使用的 Prompt 模板库。您可以根据您的短剧类型，直接复制对应的 Prompt 内容到 API 请求的 highlight_segment_prompt、highlight_start_prompt 和 highlight_ending_prompt 参数中。

通用模板

如果您不确定使用哪种特定风格，或者您的短剧内容较为综合，可以使用以下通用模板。它旨在平衡叙事、节奏和钩子，适用于大多数情况。

整体风格（用于 highlight_segment_prompt）：

开头（用于 highlight_start_prompt）：

结尾（用于 highlight_ending_prompt）：

爽感逆袭_打脸复仇

整体风格（用于 highlight_segment_prompt）：

开头（用于 highlight_start_prompt）：

结尾（用于 highlight_ending_prompt）：