参考视频生成商品口播与分镜算子，面向电商短视频创作场景。算子会联合理解参考视频、目标商品图片和可选的自然语言要求，生成可直接交给下游文生视频流程的标准分镜包。

算子 ID：las_video_storyboard_gen

核心能力 #

• 联合理解参考视频画面、口播和目标商品图片，识别商品核心用途、使用对象和可见卖点证据。
• 支持参考分镜、文案、卖点、钩子或自由融合，并通过 user_prompt 指定创作重点。
• 默认生成最多 N+1 套候选，其中 N 为输入视频数；允许部分候选通过，但至少返回一套结构可用结果。
• 每套候选包含完整口播、完整可读分镜、逐镜头结构化描述，以及生成依据和创作说明。
• 输出与标准 storyboard bundle 协议对齐，可继续交给文生视频或其他分镜下游处理。

效果展示 #

支持的地域 #

• 北京：cn-beijing
• 上海：cn-shanghai
• 广州：cn-guangzhou

算子性能 #

输入要求 #

输出要求 #

• 计费标准

  细分项	计费标准说明
  计费项	包含算子“基础调用费用”和“文案生成-视频理解”两个计费项，计费时，实际收费的费用为两个计费项的费用之和。 基础调用费用：每次调用算子时，产生的算子调用费用。 文案生成-视频理解： 算子生成爆款文案产生的费用。 此部分的费用基于输入视频的时长进行用量统计计费，且计费时，会基于使用的算子模型档位(请求参数model_tier )按一定的折算系数，将计费时长进行折算。
  计费类型	按量计费，按实际的计费用量每小时出账。计费精度：毫秒级精度，四舍五入
  单价	“基础调用费用”和“文案生成-视频理解”两个计费项的单价不一致，详情参见下表。

• 计费详情
  计费公式：总费用 = 基础调用费用 + 文案生成费用 = 1 元 + 文案生成-系数基础费用单价 * 输入视频总时长 * 计费时长折算系数

  计费项	单价	算子模型档位	计费时长折算系数
  基础调用费用	1 元/次	不涉及	不涉及
  文案生成-视频理解	1.5 元/分钟	基础版 请求参数model_tier 设置为 standard	1
  		增强版 请求参数model_tier 设置为 pro	2

• 计费示例
  输入了 3 个时长为 1 分钟的参考视频，并设置算子的模型档位为 pro（增强版）时：

  • 时长折算系数为 ：2。
  • 实际费用为：
    费用 = 1 元 + 1.5 元/分钟 * 1 分钟*3*2= 10 元

API 调用说明 #

• 本算子的 API 为异步任务接口，您需要通过 submit 接口提交任务，再通过 Poll 接口获取任务运行状态，并获取算子处理结果。同时，本算子支持异步回调能力（Callback），您可在发起算子调用任务时设置回调参数callback.url，LAS 会向该 URL 发送 HTTP POST 通知，异步回调的使用指导可参见 异步回调 API。
• 注意，任务提交后，任务的 task_id 有效期为 3 天，超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit #

接口说明 #

提交参考视频生成商品口播与分镜的异步任务。算子会理解参考视频和目标商品图片，生成多套标准口播文案。

请求参数 #

返回数据 #

示例 #

请求示例

export OUTPUT_TOS_PATH="tos://path/to/video_storyboard_gen_results"

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_video_storyboard_gen",
  "operator_version": "v1",
  "data": {
    "video_urls": [
      "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_video_storyboard_gen/v1/input_video_01.mp4",
      "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_video_storyboard_gen/v1/input_video_02.mp4"
    ],
    "product_image_urls": [
      "https://${LAS_TOS_BUCKET}.${TOS_ENDPOINT}/operator_cards_serving/public/${LAS_ENVIRONMENT}/las_video_storyboard_gen/v1/input_image_01.png"
    ],
    "user_prompt": "请展示割草机好用耐造，适用各种场景。",
    "output_tos_path": "$OUTPUT_TOS_PATH"
  }
}'

返回示例

{
  "metadata": {
    "task_id": "task-20260812150000-abc123",
    "task_status": "PENDING",
    "business_code": "0",
    "error_msg": ""
  }
}

错误码 #

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_video_storyboard_gen",
  "operator_version": "v1",
  "task_id": "task-20260812150000-abc123"
}'

返回示例

{
  "metadata": {
    "task_id": "task-20260812150000-abc123",
    "task_status": "COMPLETED",
    "submit_time": "2026-08-12T15:00:00+08:00",
    "end_time": "2026-08-12T15:06:00+08:00",
    "business_code": "0",
    "error_msg": ""
  },
  "data": {
    "result_urls": [
      "tos://bucket/output/runs/run_x/variants/variant_001/storyboard_bundle_manifest.json"
    ]
  }
}

错误码 #