分镜脚本生成算子面向剧本生产和电商口播视频工作流，将输入文本转换为标准 storyboard_bundle。当前提供两种能力：剧本结合人物、道具、场景三个资产 JSON 生成分镜，以及口播文案直接生成分镜。

算子 ID：las_storyboard_rewrite

核心功能 #

• 剧本和权威资产表转分镜：保留输入人物、道具、场景资产的标识和设定，将剧本拆解为镜头，并把每个镜头绑定到对应资产。
• 口播文案转分镜：保留口播原意和核心卖点，按语义组织镜头时长、画面动作、口播及可直接用于后续视频生成的结构化描述。
• 画面忠实扩展：输入中已有画面和动作时优先沿用并补足必要细节；只有口播时根据文案可验证内容设计画面，避免无依据虚构。
• 标准结果交付：统一输出 storyboard_bundle_manifest.json，关联分镜、人物、场景、道具及变更与校验报告。

效果展示 #

支持的地域 #

• 北京：cn-beijing

算子性能 #

输入要求 #

输出要求 #

• 计费标准

  细分项	计费标准说明
  计费项	包含以下两个计费项： 基础调用费用：调用算子的固定费用。 脚本生成- 图片理解费用：按输入的图片数量统计用量进行计费。 脚本生成-文字理解费用：按输入的文本统计用量进行计费。
  计费类型	按量计费，按实际的计费用量每小时出账。
  单价	不同计费项的单价不一致，详情见下表。

• 计费详情

  计费项	单价
  基础调用费用	4 元/次
  脚本生成-图片理解费用	0.2 元/张
  脚本生成-文字片理解费用	0.8 元/千字

API 调用说明 #

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

Submit #

接口说明 #

提交分镜脚本异步任务。当前支持“剧本 + 人物/道具/场景三个资产 JSON 转分镜”和“口播文案转分镜”两种模式。

请求参数 #

返回数据 #

示例 #

请求示例

示例1：剧本转分镜

export OUTPUT_TOS_PATH="tos://bucket/output/storyboard_rewrite"

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_storyboard_rewrite",
  "operator_version": "v1",
  "data": {
    "input_url": "tos://bucket/input/episode_01.md",
    "characters_registry_url": "tos://bucket/input/characters_registry.json",
    "prop_registry_url": "tos://bucket/input/prop_registry.json",
    "scene_registry_url": "tos://bucket/input/scene_registry.json",
    "min_shot_duration": 4,
    "max_shot_duration": 15,
    "output_tos_path": "'$OUTPUT_TOS_PATH'"
  }
}'

示例2：口播文案转分镜

export OUTPUT_TOS_PATH="tos://bucket/output/storyboard_rewrite"

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_storyboard_rewrite",
  "operator_version": "v1",
  "data": {
    "workflow_mode": "voiceover",
    "source_text": "这款双层沥水篮采用细密网孔，淘洗小米不易漏出，内外两层还能拆开单独使用。",
    "reference_images": [
      "tos://bucket/input/product_01.png"
    ],
    "min_shot_duration": 4,
    "max_shot_duration": 15,
    "output_tos_path": "'$OUTPUT_TOS_PATH'"
  }
}'

返回示例

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

错误码 #

Poll #

接口说明 #

查询分镜脚本生成任务的状态和结果。

请求参数 #

返回数据 #

result_url 指向 storyboard_bundle_manifest.json。manifest 会关联以下结果文件：

请求示例

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

返回示例

{
  "metadata": {
    "task_id": "task-20260814150000-abc123",
    "task_status": "COMPLETED",
    "submit_time": "2026-08-14T15:00:00+08:00",
    "end_time": "2026-08-14T15:04:00+08:00",
    "business_code": "0",
    "error_msg": ""
  },
  "data": {
    "result_url": "tos://bucket/output/v000/storyboard_bundle_manifest.json"
  }
}

错误码 #

人物/道具/场景三资产 JSON 示例 #

剧本转分镜时，人物、道具、场景三类资产必须全部提供。每类资产可选择TOS URL或者HTTP URL，不要求三类使用相同的传递方式。
三个 JSON 推荐 至少需要包含稳定 ID、名称和视觉描述字段（可参考下方示例）。剧本转分镜时，建议使用 LAS 剧本解析算子产出资产 JSON 表。

• 人物资产 JSON 示例

  {
    "characters": [
      {
        "character_id": "char_001",
        "name": "林晓",
        "description": "年轻的产品体验者",
        "visual_features": "黑色短发，浅色家居服"
      }
    ]
  }
  

• 道具资产 JSON 示例

  {
    "props": [
      {
        "prop_id": "prop_001",
        "name": "双层沥水篮",
        "description": "用于清洗和沥水的双层厨具",
        "visual_features": "外层盆与细密漏网可拆分"
      }
    ]
  }
  

• 场景资产 JSON 示例

  {
    "scenes": [
      {
        "scene_id": "scene_001",
        "name": "家庭厨房水槽",
        "description": "明亮整洁的家用厨房操作区",
        "visual_features": "浅色台面，不锈钢水槽"
      }
    ]
  }