AI 数据湖服务
AI 数据湖服务
算子广场
请输入
- 文档首页
AI 数据湖服务视频视频生成短剧·影视解说智作
复制全文
下载 pdf短剧·影视解说智作
文档反馈
问问助手“短剧·影视解说智作”算子能够基于多集短剧、电视剧或单部电影素材，自动建立剧情事件索引，按照故事线索，以 short、mid、long 三种大致时长范围规划跳剪解说视频。算子会自动完成画面剪辑、解说稿生成、TTS 配音、字幕生成、混音渲染和结果上传，支持中英文解说、文案风格和语速控制、原声片段与开场策略、高质量预设音色、普通音质下的参考音频或资产库音色复刻、资产库 BGM 选材与混音，以及字幕底框和位置控制，一次任务产出一条适合视频平台投放的高光解说素材。
算子介绍
算子 ID：las_short_drama_highlight_narration
适用场景
- 短剧投流素材生产：基于短剧素材生成高光解说视频，可用于视频平台推广。
- 影视二次创作：从电视剧、电影或长视频中发现可讲述的剧情线索，生成适合短视频传播的解说短片。
核心能力
- 智能理解与一体化成片输出：
- 长剧集剧情理解：自动分析多集短剧、电视剧或电影素材，抽取关键事件、人物关系、冲突推进和视觉高光。
- 线索发现与筛选：发现并筛选适合生成高光解说的候选线索，包括主线、人物线、冲突线和关系线。
- 投流化密集解说：默认生成节奏紧凑、先抛钩子、结尾留悬念的解说稿，并自动完成 TTS 配音与字幕渲染。
- 字幕样式与位置控制：支持选择半透明模糊、白色圆角或黑色圆角字幕底框，并通过 subtitle_position 控制字幕位置。
- 灵活的解说风格与高质量的解说编排：
- 文案风格与语速控制：支持六种预置解说文案风格或最长 1000 个字符的自定义风格描述，并可选择慢速、正常或快速解说。
- 预置典型解说场景模版：为您提供 爽剧反转、冷静纪实、轻松口语、犀利吐槽、悬疑推理、温情叙事等解说场景模板，为您提供对应解说场景下更高质量的解说视频输出。
- 原声与开场编排：可在正文中穿插符合条件的原声片段，并独立控制原声、带解说或关闭开场规划。
- TTS 音质与音色控制：支持高质量预设音色，也支持在普通音质档位通过参考音频或资产库音色复刻声音。
- 资产库选材：可通过资产库精确指定音色或 BGM，也可按标签自动选材，或根据内容上下文推断选材偏好。
- 多语言解说：支持通过 narration_language 生成中文或英文解说。
效果展示
【短剧投流素材生产示例】
- 输入视频
- ep01
-
Replay Play00:00 / 02:20 Live 00:00FullscreenCssfullscreenClick and hold to drag
- ep02
-
Replay Play00:00 / 02:20 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 输出视频
- 示例1
-
Replay Play00:00 / 01:00 Live 00:00FullscreenCssfullscreenClick and hold to drag
——以系统预置解说音色为例，您可按需提供参考音色
【影视二创】
- 输入视频
-
Replay Play00:00 / 04:09 Live 00:00FullscreenCssfullscreenClick and hold to drag
- 输出视频
-
Replay Play00:00 / 02:01 Live 00:00FullscreenCssfullscreenClick and hold to drag
——基于输入的长视频，提取剧情线索生成解说短片
支持的地域
- 北京：cn-beijing
- 上海：cn-shanghai
- 广州：cn-guangzhou
算子性能
细分项 | 性能影响说明 |
最大 Submit RPM | 5 |
最大 Poll RPM | 300 |
输入与输出要求
输入要求
输出要求
计费说明
- 计费标准
-
- 细分项计费标准说明计费项包含两个计费项：输入原片理解费用、输出解说视频费用。算子实际任务产生的费用为两个计费项的费用之和。
- 输入原片理解费用：基于所有输入原片总视频时长统计用量，进行计费。
- 输出解说视频费用：基于所有输出解说视频总时长统计用量进行计费。您可通过 poll 接口返回的duration_s 参数快速查看每个输出视频的时长（单位为：秒）。
计费类型按量计费，单位：元/分钟，按实际的计费用量每小时出账。计费精度：毫秒级精度，去尾单价不同细分计费项的单价不同，详情如下。
- 计费详情
- 计费公式：总费用 = 输入原片理解费用 + 输出解说视频费用
-
- 细分计费项细分单价输入原片理解费用输入原片视频 [0min , 60min]部分0.6 元/分钟输入原片视频 超出 60min 部分0.45 元/分钟输出解说视频费用不涉及2.1 元/分钟
- 计费示例
- 示例场景：输入了 30 个 3分钟的短剧视频，经过算子处理后，输出了 20 个 1分钟的解说视频 。
- 费用详情：
- 所有输入原片总视频时长 = 30 * 3分钟 = 90 分钟；
- 所有输出解说视频总时长 = 20 * 1分钟 = 20分钟；
- 总费用 = 输入原片理解费用 + 输出解说视频费用
- = （60分钟 * 0.6元/分钟 + 30分钟 * 0.45元/分钟）+20分钟 * 2.1元/分钟
- = 91.5 元
- 出账计费单元
- 当前调用本算子产生的费用账单，在账单明细中展示的计费单元为“剧本生成”，您在查看账单时可关注下此差异。
注意与前提
Rest API 调用
API 调用说明
- 本算子的 API 为异步任务接口，您需要通过 Submit 接口提交任务获得任务的 task_id，再通过 Poll 接口获取对应任务（task_id）运行状态，并获取算子处理结果。
- 注意，任务提交后，任务的 task_id 有效期为 3 天，超过 3 天后即无法通过此 task_id 来获取算子处理结果。
Submit
接口说明
提交“短剧·影视解说智作”任务。提交成功后返回任务 ID，可通过 Poll 接口查询任务状态和生成视频。
请求参数
operator_id string 必选 示例值: las_short_drama_highlight_narration
算子 ID
operator_version string 必选 示例值: v1
算子版本
data ShortDramaHighlightNarrationReq 必选
“短剧·影视解说智作”请求参数
input_videos list of string 必选 示例值: ["tos://bucket/drama/ep01.mp4", "tos://bucket/drama/ep02.mp4"]
输入素材视频列表，支持 tos://、http://、https://，视频格式支持 mp4、mov、mkv。电影仅限 1 个视频；短剧和电视剧需按剧集顺序提交，并保留数组顺序。
target_narration_duration string Optional 示例值: mid
单条解说视频的大致时长范围。可选值：short（约 1 分钟）、mid（1 至 3 分钟）、long（3 分钟及以上），默认 mid。实际时长以 Poll 响应中的 duration_s 为准。
source_content_type string Optional 示例值: auto
输入素材类型。可选值：auto（自动识别）、short_drama（短剧）、movie（电影）、tv_series（电视剧），默认 auto。电影仅限 1 个视频；电视剧支持单集或多集，单集和总时长均不超过 300 分钟（包含边界）、单集最大 10 GiB、总大小默认最大 20 GiB。
narration_language string Optional 示例值: zh
解说语言。可选值：en（英文）、zh（中文）。不传时默认为中文。
narration_style NarrationStyle Optional 示例值: {"type":"preset","name":"爽剧反转"}
解说文案风格，支持内置模板和自定义风格。
type string Optional 示例值: preset
风格类型。可选值：preset、custom，默认 preset。
name string 必选 示例值: 爽剧反转
风格名称。type=preset 时可选 爽剧反转、冷静纪实、轻松口语、犀利吐槽、悬疑推理、温情叙事；type=custom 时须填写非空的自定义风格描述，最长 1000 个字符。
narration_speed string Optional 示例值: normal
解说语速。可选值：slow、normal、fast，默认 normal。
enable_original_audio_windows boolean Optional 示例值: false
是否在正文中插入原声片段，默认 false。开启后会筛选台词完整、冲突明确的片段，片段内暂停解说并保留原声。受素材质量和筛选门禁影响，开启后也可能没有满足条件的片段。
opening_hook_mode string Optional 示例值: auto
开场高光策略，默认 auto。可选值：auto（有合格片段时使用无解说原声开场，否则回退为带解说开场）、original_audio（强制原声开场，无合格片段时任务失败）、narrated（使用带解说开场）、off（关闭独立开场规划）。该参数与正文原声片段开关相互独立。
tts_audio_quality string Optional 示例值: high-quality
TTS 音频档位。可选值：high-quality（音质更好，但不支持参考音频或资产库音色）和 normal（支持参考音频或资产库音色），默认 normal。
tts_voice string Optional 示例值: 青年男声
高质量档位的预设音色。可选值：青年女声、甜美女声、青年男声、少年男声。仅当显式设置 tts_audio_quality=high-quality 时可填写；该档位下不传时默认 青年男声。
subtitle_blur_mode string Optional 示例值: gaussian
解说字幕底框模式。可选值：gaussian（半透明模糊底框）、white（白底圆角底框）、black（黑底圆角底框）。不传时默认 gaussian。
subtitle_position string Optional 示例值: auto
解说字幕位置。可选值：auto（自动检索原片字幕所在位置，未检索到则放置在画面底部）、top（顶部）、bottom（底部）。不传时默认 auto。
tts_clone_prompt_audio_url string Optional 示例值: tos://bucket/audio/voice.wav
TTS 音色克隆参考音频地址，仅适用于 tts_audio_quality=normal。支持 tos://、http:// 或 https://，以及 wav、mp3 格式。与 material_scope.voice 互斥；未选择资产库音色时，不传或传空白字符串会使用执行服务的默认音色。
material_scope MaterialScope Optional
资产库音色与 BGM 选择，可单独选择或同时选择。不传或传 null 时沿用原有行为；传入非空对象时，至少需要配置一个非空角色。
voice MaterialSelector Optional
资产库音色选择，仅适用于 tts_audio_quality=normal。不能与非空的 tts_clone_prompt_audio_url 或高质量预设音色参数 tts_voice 同时使用。
mode string 必选 示例值: EXACT
选择方式，仅支持大写的 EXACT 和 AUTO。EXACT 指定素材；AUTO 按标签选择或根据上下文推断偏好。
material_ids list of string Conditional 示例值: ["mat-voice-example"]
默认空数组。EXACT 必须且只能指定一个去除首尾空白后非空的素材 ID；AUTO 必须省略或传空数组。
filters object Optional 示例值: {"gender":"FEMALE","language":["ZH","EN"]}
默认空对象。最多 8 个非空标签键，每个值为非空字符串或包含 1～20 个非空字符串的数组。AUTO 必须在非空 filters 与 infer_filters=true 中二选一；EXACT 必须省略或传空对象。标签需使用资产库当前词表中的 Value 编码。
infer_filters boolean Optional 示例值: true
默认 false。AUTO 设为 true 时根据内容类型、解说风格、语言等上下文推断偏好；不能与非空 filters 同时使用。EXACT 必须省略或设为 false。
bgm MaterialSelector Optional
资产库 BGM 选择。AUTO 会按上下文或标签选择音乐；同等匹配时，优先选择时长覆盖并接近最终成片的曲目。当前每条成片使用一首 BGM。
mode string 必选 示例值: AUTO
选择方式，仅支持大写的 EXACT 和 AUTO。EXACT 指定素材；AUTO 按标签选择或根据上下文推断偏好。
material_ids list of string Conditional 示例值: ["mat-bgm-example"]
默认空数组。EXACT 必须且只能指定一个去除首尾空白后非空的素材 ID；AUTO 必须省略或传空数组。
filters object Optional 示例值: {"style":["WARM"]}
默认空对象。最多 8 个非空标签键，每个值为非空字符串或包含 1～20 个非空字符串的数组。AUTO 必须在非空 filters 与 infer_filters=true 中二选一；EXACT 必须省略或传空对象。标签需使用资产库当前词表中的 Value 编码。
infer_filters boolean Optional 示例值: true
默认 false。AUTO 设为 true 时结合解说摘要与成片时长等上下文推断偏好；不能与非空 filters 同时使用。EXACT 必须省略或设为 false。
output_tos_path string Optional 示例值: tos://bucket/output/highlight/
结果输出 TOS 目录。传入时必须使用 tos:// 路径；不传时返回可访问的预签名结果链接，链接有效期为 3 天。
pending_timeout_minutes integer Optional 示例值: 120
任务处于 PENDING 状态的最长等待时间，单位分钟，取值范围为 30 至 4320。不传时不启用 PENDING 等待超时；超时后任务状态为 EXPIRED。
返回数据
metadata metadata
请求元信息
task_id string 示例值: task-20260715120000-abc123
异步任务 ID，用于后续查询任务状态和结果。
task_status string 示例值: PENDING
提交成功时固定为 PENDING，表示任务已进入异步等待队列。
business_code string 示例值: 0
业务码。0 表示提交成功。
error_msg string
异常信息。提交成功时为空字符串。
request_id string 示例值: 20260819120000ABCDEF
当前 Submit 请求 ID，用于日志追踪和问题排查。
示例
请求示例
返回示例
错误码
媒体下载、格式/时长/大小校验、模型处理、音色参考音频以及 TOS 读写失败属于异步任务失败，不会在成功受理后的 Submit 响应中作为同步 HTTP 400 返回。请通过 Poll 获取执行侧返回的业务码和错误信息。
使用资产库选材时，没有匹配素材、指定版本不可用、参考音频下载失败或 BGM 处理失败会导致任务失败；算子不会静默替换为默认音色，也不会在缺少所选 BGM 的情况下交付成片。请通过 Poll 检查 metadata.task_status、business_code 和 error_msg。
Poll
接口说明
查询“短剧·影视解说智作”任务的执行状态和结果。任务完成后可获取生成的视频。
请求参数
返回数据
metadata metadata
请求元信息
task_id string 示例值: task-20260715120000-abc123
异步任务 ID。
task_status string 示例值: COMPLETED
任务状态，可选值为 ACCEPTED、PENDING、RUNNING、COMPLETED、FAILED、EXPIRED、CANCELLED、TIMEOUT、UNKNOWN。其中 ACCEPTED、PENDING、RUNNING、UNKNOWN 为非终态，其余为终态。执行侧的 success 会归一为 COMPLETED，failed 和 partial_success 会归一为 FAILED。
business_code string 示例值: 0
业务码。0 表示管控面处理正常；执行侧 metadata 中的非空业务码会原样覆盖该值，应结合 task_status 和 error_msg 判断。
error_msg string
状态或错误信息。完成成功时通常为空；非终态可携带当前任务信息，失败时返回具体原因。
request_id string 示例值: 20260819120500ABCDEF
当前 Poll 请求 ID，用于日志追踪和问题排查。
submit_time string 示例值: 2026-08-19T12:00:00+08:00
任务提交时间，ISO 8601 格式；任务存储中无有效时间时不返回。
end_time string 示例值: 2026-08-19T12:05:00+08:00
任务结束时间，ISO 8601 格式；仅在已有有效结束时间时返回。
data ShortDramaHighlightNarrationResp
任务结果数据。非完成态或失败态通常返回空对象 {}。仅在 task_status=COMPLETED 时将 videos 视为完整成功结果。
videos list of Video
生成视频列表。每个元素对应一条高光解说视频。
video_id string 示例值: v_main_storyline_01
单条生成视频 ID。
duration_s float 示例值: 95.1
单条视频的实际时长，单位秒。具体时长由 Submit 请求中的 target_narration_duration 大致范围控制。
final_video_path string 示例值: tos://bucket/output/main_storyline/v_main_storyline_01/final.mp4
最终成片视频的 TOS 路径。
final_video_url string 示例值: https://example.com/final.mp4
最终成片视频的预签名链接，您可单击链接直接下载生成的结果视频，预签名有效期为 3 天。
示例
请求示例
返回示例
错误码
异步执行失败同样通过 HTTP 200 的 Poll 响应返回：metadata.task_status 为 FAILED、EXPIRED、CANCELLED 或 TIMEOUT，执行侧提供的业务码和错误信息会保留在 metadata.business_code 与 metadata.error_msg 中。不要仅依据 Poll 的 HTTP 状态判断任务是否成功。
最近更新时间：2026.11.05 11:46:59
这个页面对您有帮助吗？
有用
有用
无用
无用