“短剧·影视解说智作”算子能够基于多集短剧或单部电影素材，自动建立剧情事件索引，按照故事线索，以 short、mid、long 三种大致时长范围规划跳剪解说视频。算子会自动完成画面剪辑、解说稿生成、TTS 配音、字幕生成、混音渲染和结果上传，支持中英文解说、文案风格和语速控制、原声片段与开场策略、高质量预设音色或普通音质下的参考音频克隆，以及字幕底框和位置控制，一次任务产出一条适合视频平台投放的高光解说素材。

算子 ID：las_short_drama_highlight_narration

适用场景 #

• 短剧投流素材生产：基于短剧素材生成高光解说视频，可用于视频平台推广。
• 影视二次创作：从电影或长视频中发现可讲述的剧情线索，生成适合短视频传播的解说短片。

核心能力 #

• 智能理解与一体化成片输出：
  • 跨集剧情理解：自动分析多集短剧或电影素材，抽取关键事件、人物关系、冲突推进和视觉高光。
  • 线索发现与筛选：发现并筛选适合生成高光解说的候选线索，包括主线、人物线、冲突线和关系线。
  • 投流化密集解说：默认生成节奏紧凑、先抛钩子、结尾留悬念的解说稿，并自动完成 TTS 配音与字幕渲染。
  • 字幕样式与位置控制：支持选择半透明模糊、白色圆角或黑色圆角字幕底框，并通过 subtitle_position 控制字幕位置。
• 灵活的解说风格与高质量的解说编排：
  • 文案风格与语速控制：支持六种预置解说文案风格或最长 1000 个字符的自定义风格描述，并可选择慢速、正常或快速解说。
    • 预置典型解说场景模版：为您提供 爽剧反转、冷静纪实、轻松口语、犀利吐槽、悬疑推理、温情叙事等解说场景模板，为您提供对应解说场景下更高质量的解说视频输出。
  • 原声与开场编排：可在正文中穿插符合条件的原声片段，并独立控制原声、带解说或关闭开场规划。
  • TTS 音质与音色控制：支持高质量预设音色，也支持在普通音质档位通过参考音频克隆音色。
• 多语言解说：支持通过 narration_language 生成中文或英文解说。

效果展示 #

支持的地域 #

• 北京：cn-beijing

算子性能 #

输入要求 #

输出要求 #

• 计费标准

  细分项	计费标准说明
  计费项	包含两个计费项：输入原片理解费用、输出解说视频费用。算子实际任务产生的费用为两个计费项的费用之和。 输入原片理解费用：基于所有输入原片总视频时长统计用量，进行计费。 输出解说视频费用：基于所有输出解说视频总时长统计用量进行计费。您可通过 poll 接口返回的duration_s 参数快速查看每个输出视频的时长（单位为：秒）。
  计费类型	按量计费，单位：元/分钟，按实际的计费用量每小时出账。计费精度：毫秒级精度，去尾
  单价	不同细分计费项的单价不同，详情如下。

• 计费详情
  计费公式：总费用 = 输入原片理解费用 + 输出解说视频费用

  细分计费项	细分	单价
  输入原片理解费用	输入原片视频 [0min , 60min]部分	0.2 元/分钟
  	输入原片视频 超出 60min 部分	0.3 元/分钟
  输出解说视频费用	不涉及	1.2 元/分钟

• 计费示例

  • 示例场景：输入了 30 个 3分钟的短剧视频，经过算子处理后，输出了 20 个 1分钟的解说视频 。
  • 费用详情：
    • 所有输入原片总视频时长 = 30 * 3分钟 = 90 分钟；
    • 所有输出解说视频总时长 = 20 * 1分钟 = 20分钟；
    • 总费用 = 输入原片理解费用 + 输出解说视频费用
      = （60分钟 * 0.2元/分钟 + 30分钟 *0.3 元/分钟）+ 20分钟*1.2 元/分钟
      = 45 元

• 出账计费单元
  当前调用本算子产生的费用账单，在账单明细中展示的计费单元为“剧本生成”，您在查看账单时可关注下此差异。

API 调用说明 #

• 本算子的 API 为异步任务接口，您需要通过 Submit 接口提交任务获得任务的 task_id，再通过 Poll 接口获取对应任务（task_id）运行状态，并获取算子处理结果。
• 注意，任务提交后，任务的 task_id 有效期为 3 天，超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit #

接口说明 #

提交“短剧·影视解说智作”任务。提交成功后返回任务 ID，可通过 Poll 接口查询任务状态和生成视频。

请求参数 #

返回数据 #

示例 #

请求示例

# 可选：将 OUTPUT_TOS_PATH 设置为本账号可写入的 TOS 目录
export OUTPUT_TOS_PATH="tos://bucket/output/highlight_narration/"

curl --location "$https://operator.las.cn-beijing.volces.com/api/v1/submit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "operator_id": "las_short_drama_highlight_narration",
    "operator_version": "v1",
    "pending_timeout_minutes": 120,
    "data": {
        "input_videos": [
            "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_short_drama_highlight_narration/v1/episode_01.mp4",
            "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_short_drama_highlight_narration/v1/episode_02.mp4"
        ],
        "target_narration_duration": "short",
        "narration_language": "zh",
        "narration_style": {
            "type": "preset",
            "name": "爽剧反转"
        },
        "narration_speed": "normal",
        "enable_original_audio_windows": false,
        "opening_hook_mode": "auto",
        "tts_audio_quality": "high-quality",
        "tts_voice": "青年男声",
        "subtitle_blur_mode": "gaussian",
        "subtitle_position": "bottom",
        "output_tos_path": "$OUTPUT_TOS_PATH"
    }
}'

返回示例

{
  "metadata": {
    "task_id": "task-20260715120000-abc123",
    "task_status": "PENDING",
    "business_code": "0",
    "error_msg": "",
    "request_id": "20260819120000ABCDEF"
  }
}

错误码 #

媒体下载、格式/时长/大小校验、模型处理、音色参考音频以及 TOS 读写失败属于异步任务失败，不会在成功受理后的 Submit 响应中作为同步 HTTP 400 返回。请通过 Poll 获取执行侧返回的业务码和错误信息。

Poll #

接口说明 #

查询“短剧·影视解说智作”任务的执行状态和结果。任务完成后可获取生成的视频。

请求参数 #

返回数据 #

示例 #

请求示例

curl --location "https://operator.las.cn-beijing.volces.com/api/v1/poll" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $LAS_API_KEY" \
--data '{
    "operator_id": "las_short_drama_highlight_narration",
    "operator_version": "v1",
    "task_id": "task-20260715120000-abc123"
}'

返回示例

{
  "metadata": {
    "task_id": "task-20260715120000-abc123",
    "task_status": "COMPLETED",
    "business_code": "0",
    "error_msg": "",
    "request_id": "20260819120500ABCDEF",
    "submit_time": "2026-08-19T12:00:00+08:00",
    "end_time": "2026-08-19T12:05:00+08:00"
  },
  "data": {
    "videos": [
      {
        "video_id": "v_main_storyline_01",
        "duration_s": 95.1,
        "final_video_path": "tos://bucket/output/highlight_narration/main_storyline/v_main_storyline_01/final.mp4",
        "final_video_url": "https://example.com/final_01.mp4"
      }
    ]
  }
}

错误码 #

异步执行失败同样通过 HTTP 200 的 Poll 响应返回：metadata.task_status 为 FAILED、EXPIRED、CANCELLED 或 TIMEOUT，执行侧提供的业务码和错误信息会保留在 metadata.business_code 与 metadata.error_msg 中。不要仅依据 Poll 的 HTTP 状态判断任务是否成功。