细分项	性能影响说明
最大 RPM	600
耗时	总耗时主要受文本长度、镜头数量、资产表规模、参考图片数量和模型调用次数影响。长剧本会按文本或剧集边界分块处理，并在生成后合并为统一资产和分镜结果。

输入与输出要求

输入要求

细分	详细要求
支持的输入数据模态	文本图片
输入格式：文本	通过请求参数 input_url或 source_text 向算子输入转分镜的输入剧本或口播文案。算子模型基于输入的文本内容判断当前转脚本的场景是“剧本转分镜”还是“口播文案转分镜”场景。剧本转分镜场景下：必须同时提供人物、道具和场景三个资产 JSON。三资产 JSON 文件推荐至少包含稳定 ID、名称和视觉描述，参考格式请参见下文的人物/道具/场景三资产 JSON 示例。剧本转分镜时，建议使用 LAS 剧本解析算子产出资产 JSON 表。
输入格式：图片	通过 reference_images 参数向算子输入参考图片，在口播文案转分镜场景下，您可按需提供参考图片。数量：单次任务最多支持输入 9 张。宽高比（宽/高）： [0.4, 2.5] 宽高长度（px）：[300,6000]
输入路径要求	通过请求参数 video_url 、reference_images提供给算子输入数据，当前支持公网 URL、TOS 路径这两种方式。公网 URL：公网可访问的 URL，格式为 http/https。公网 URL 不支持需要登录态或额外 Header 鉴权的地址；临时 URL 需在任务执行期间有效。 TOS 路径：将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后，可提供 TOS 路径，格式为tos://bucket_name/demo。 TOS 对象需存在且具备读取权限。

输出要求

细分	详细要求
输出数据模态	文本
输出路径：TOS	通过请求参数output_tos_path 指定算子输出结果的存储路径，当前支持设置为 TOS 路径。 TOS 路径：与LAS服务同主账号、同地域下，有可写权限的 TOS Bucket 目录，格式：tos://bucket/output/。

计费说明

计费标准

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

计费详情

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

注意与前提

申请开白

当前功能处于白名单阶段，使用前需提交工单申请开通。

其他

细分项	注意与前提
开通 LAS	如果您是一个全新的火山引擎用户，此前未开通过 LAS 产品，您可先开通 LAS，不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作。开通完成后可查看算子介绍文档，了解算子能力、上手引导等，详情可参见：LAS 智能数据处理算子。
费用	调用算子前，您需先了解使用算子时的模型调用费用，详情请参见大模型调用计费。
鉴权（API Key）	调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见获取 API Key 并配置。
BaseURL	调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。详情请参见获取 Base URL，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。

Rest API 调用

API 调用说明

本算子的 API 为异步任务接口，您需要通过 Submit 接口提交任务获得任务的 task_id，再通过 Poll 接口获取对应任务（task_id）运行状态，并获取算子处理结果。

注意，任务提交后，任务的 task_id 有效期为 3 天，超过 3 天后即无法通过此 task_id 来获取算子处理结果。

Submit

接口说明

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

请求参数

operator_id string 必选示例值: las_storyboard_rewrite

算子 ID。

operator_version string 必选示例值: v1

算子版本，目前仅支持 v1。

data StoryboardRewriteReqParams 必选

文本生成分镜参数。

input_url string Optional 示例值: 无

剧本或口播文件地址。与 source_text 选择提供一个，支持 http/https、tos://。

user_intent string Optional 示例值: 无

算子处理任务的意图描述，建议固定填写：”请转成分镜脚本“。

source_text string Optional 示例值: 无

内联剧本或口播文案。与 input_url 选择提供一个。

characters_registry_url string Optional 示例值: 无

人物资产 JSON 地址，剧本转分镜时传入。

prop_registry_url string Optional 示例值: 无

道具资产 JSON 地址，剧本转分镜时传入。

scene_registry_url string Optional 示例值: 无

场景资产 JSON 地址，剧本转分镜时传入。

reference_images array Optional 示例值: 无

参考图片列表，口播文案转分镜时传入

min_shot_duration integer Optional 示例值: 4

单镜头最短时长，范围 4～30 秒。

max_shot_duration integer Optional 示例值: 15

单镜头最长时长，范围 4～30 秒，且不得小于 min_shot_duration。

output_tos_path string Optional 示例值: 运行时分配

输出目录，支持 tos://，必须和api key处于同region。

返回数据

metadata metadata

请求元信息。

task_id string 示例值: task-xxx

异步任务 ID，用于查询任务状态和结果。

task_status string 示例值: PENDING

任务状态：PENDING、RUNNING、COMPLETED、FAILED、TIMEOUT。

business_code string 示例值: 0

业务码。

error_msg string

异常详情。

示例

请求示例

示例1：剧本转分镜

示例2：口播文案转分镜

返回示例

错误码

HttpStatusCode	错误码	错误信息	描述
400	Parameter.Invalid	invalid parameter	工作流、文本、资产表、镜头数或镜头时长参数不合法。
400	Tos.AccessFailed	TOS access failed	文本、资产 JSON、参考图片下载或结果上传失败。
401	Authorization.Missing	Missing Authorization	缺少鉴权。
401	ApiKey.InValid	The api key is invalid	API Key 不合法。
500	Internal.ServerError	Internal server error	服务内部错误，包括模型生成或结果校验未能完成。

Poll

接口说明

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

请求参数

名称	类型	是否必选	示例值	描述
operator_id	string	是	las_storyboard_rewrite	算子 ID。
operator_version	string	是	v1	算子版本。
task_id	string	是	task-xxx	Submit 返回的异步任务 ID。

返回数据

metadata metadata

任务元信息。

task_id string 示例值: task-xxx

异步任务 ID。

task_status string 示例值: COMPLETED

任务状态：PENDING、RUNNING、COMPLETED、FAILED、TIMEOUT。

submit_time string 示例值: 2026-08-14T15:00:00+08:00

任务提交时间，ISO 8601 格式。

end_time string 示例值: 2026-08-14T15:04:00+08:00

任务结束时间，ISO 8601 格式。

business_code string 示例值: 0

业务码。

error_msg string

异常详情。

data StoryboardRewriteResponse

任务成功时返回的数据。

result_url string 示例值: tos://bucket/output/v000/storyboard_bundle_manifest.json

标准 storyboard bundle manifest 地址。

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

文件	内容
shot_registry.json	分镜列表、镜头时长、口播、结构化画面描述和视频生成提示词。
characters_registry.json	人物资产及其视觉设定。
prop_registry.json	道具或商品资产及其视觉设定。
scene_registry.json	场景资产及其视觉设定。
change_report.json	生成摘要、校验状态、待补资产和生成诊断。

示例

请求示例

返回示例

错误码

HttpStatusCode	错误码	错误信息	描述
400	TaskId.Invalid	The task id is invalid	任务 ID 不合法或任务不存在。
401	Authorization.Missing	Missing Authorization	缺少鉴权。
401	ApiKey.InValid	The api key is invalid	API Key 不合法。
500	Internal.ServerError	Internal server error	服务内部错误。

参考

人物/道具/场景三资产 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": "浅色台面，不锈钢水槽"
}
]
}

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

AI 数据湖服务