# 操作指引\-高光智剪（短剧）
本功能用于提交一个异步的短剧高光智剪任务，按照对输入剧集的角色和剧情故事线理解，提取高光片段并按照剪辑要求（时长范围、产出个数、顺剪/跳剪等剪辑手法等）生成高光混剪、单集预告等多种混剪视频。
## 功能说明
|功能名称|是否必选|功能描述|
|---|---|---|
|视频链接|是|待处理的短剧原片视频 URL 列表。
- **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 。
- **支持格式**：mp4, flv, ts, avi, mov, wmv, mkv 等主流视频格式。
- **数量限制**：单次任务最多支持传入 30 个视频文件。
- **累计时长**：所有输入文件的累计总时长不得超过 45 分钟。
- **输入分辨率限制**：最高支持 1080p。
- **输入素材要求**：必须同时包含视频流和音频流。
- **视频画面要求**：视频画面下半部分（垂直位置 0\.5\-1\.0 范围内）必须包含清晰居中的中文字幕。
- **音频流要求**：视频的音频轨道中必须包含清晰可识别的中文对话文本。仅包含 BGM（含歌词）、纯音乐、语气词或无有效语义的声音，将无法准确识别剧情逻辑。|
|生成高光混剪视频|否|是：生成并输出高光混剪视频。
否：不生成高光混剪视频。|
|是否返回封面|否|是：在任务结果中返回混剪视频的封面图 URL。
否：不返回封面图。|
|高光剪辑模板配置|否|高光视频剪辑模板配置，用于控制最终输出视频的视觉风格。如果生成高光混剪视频为否，此功能将不展示。通过此功能，您可以选择是仅进行基础剪辑，还是应用包含剧名、角标等元素的“短剧三要素”视觉模板。详见下文 高光剪辑配置配置说明。|
|高光智剪参数配置|否|高光智剪参数配置，用于控制最终输出视频的时长与个数。通过此参数，您可以定义输出视频的总时长和个数、剪辑模式（顺剪或混剪），以及是否需要输出详细的分镜信息。如果留空，则默认使用热门短剧1模板。详见下文高光智剪参数配置说明。|
|智能精彩前置|否|精彩前置（开场钩子）功能参数配置，用于控制是否在视频开头添加一个极具吸引力的“钩子”片段来留住观众。您可以通过此参数开启或关闭该功能，并设置钩子片段的时长及筛选标准。如果留空，则默认在视频开头添加精彩前置片段。详见智能精彩前置说明。|
|高光智剪视频结尾选取|否|复用正片剧集结尾：先复用正片剧集结尾。
智能选取模式：智能选取模式。|
|是否返回高光片段和分镜标签|否|是：在任务列表中额外返回标签字段，可用于内容盘点、投放分组、素材检索等下游场景。
否：不返回标签字段。|
## 高光剪辑配置
|功能名称|是否必选|功能描述|
|---|---|---|
|剪辑模式|否|基础剪辑：不添加额外视觉元素。
模版剪辑：使用指定的“短剧三要素”视觉模板。|
|短剧模版|否|“短剧三要素”视觉模板名称，决定剧名、角标、提示语的样式和位置。默认为 热门短剧1。支持取值：
- 热门短剧1
- 热门短剧2
- 热门短剧3
- 热门短剧4
- 热门短剧5|
|短剧名|否|短剧名称，将显示在视频画面中。不超过 22 个字符。|
|提示语|否|短剧提示语，将显示在画面左侧或右侧。不超过 20 个字符。|
## 高光智剪参数配置
|功能名称|是否必选|功能描述|
|---|---|---|
|是否返回高光分镜信息|否|是否在任务结果中输出详细的分镜信息。|
|高光视频最小时长|否|期望输出高光视频的最小时长（单位：秒，默认为 30）。
**注意**
算法最终输出的高光时长会尽量趋近于您设置的 min\_duration 和 max\_duration 范围，实际时长与设定值可能存在几秒钟的微小误差。|
|高光视频最大时长|否|期望输出高光视频的最大时长（单位：秒，默认为 180）。|
|高光视频数量|否|最多输出的高光视频数量，默认为 6。|
|剪辑模式|否|混剪：打乱高光片段的原始顺序。
顺剪：保持高光片段的原始时间顺序。|
|混剪高光提示词|否|风格定义：高光片段选取标准，仅在混剪模式下生效。你可以用自然语言描述偏好，具体使用方式可参阅精细化引导混剪模式的高光选取。
自定义开场：高光混剪开头起播点选取标准，仅在混剪模式下生效。你可以用自然语言描述偏好，具体使用方式可参阅精细化引导混剪模式的高光选取。
自定义结尾：高光混剪结尾钩子选取标准，仅在混剪模式下生效。你可以用自然语言描述偏好，具体使用方式可参阅精细化引导混剪模式的高光选取。|
|优先选用片段|否|用户期望优先选用的原片内容或片段。仅在混剪模式下生效。支持填写多个。
选集：优先选用的输入视频序号，从 0 开始计数。
开始时间：优先片段在该输入视频中的开始时间（单位：秒）。与结束时间一并提供时，表示该集指定时间区间优先。
结束时间：优先片段在该输入视频中的结束时间（单位：秒）。|
## 智能精彩前置
|功能名称|是否必选|功能描述|
|---|---|---|
|智能精彩前置|否|是否启用精彩前置（开场钩子）功能。|
|钩子片段时长|否|最小时间：开场钩子片段的最小时长（单位：秒）。默认为 5。
最大时间：开场钩子片段的最大时长（单位：秒）。默认为 15。|
|单个高光片段最小持续时长|否|构成开场钩子的单个高光片段的最小持续时长（单位：秒）。|
|单个高光片段所需达到的最低高光分|否|构成开场钩子的单个高光片段所需达到的最低高光分。范围 \[1, 5\]。|
|开场钩子提示词|否|精彩前置片段选取标准，用自然语言描述开头钩子的筛选偏好。具体使用方式可参阅示例。|