短剧剧本修订算子面向短剧剧本生成结果，根据明确的局部修改要求，同步修订人物表、场景表、道具表、分集剧本和可选的结构化分集文件，并将修订结果及差异文件写入 TOS。

算子介绍

适用场景

名称替换：修改人物名、别名、组织名、地点名或专有名词译名。

资产描述调整：调整人物身份与穿搭妆造、场景描述、道具名称或道具外观。

局部文本清理：删除或替换剧本和资产表中的残留词、错误称谓或不一致表达。

本地化返修：统一修改专有名词表达，同时保留无需改写的普通业务术语。

生成后返修：在短剧剧本生成结果基础上做小范围修改，避免重新生成整部短剧。

核心能力

生成结果目录修订：读取短剧剧本生成算子产出的 TOS 目录，复用其中的人物表、场景表、道具表和分集脚本。

局部修改范围检查：执行前检查修改要求是否属于明确的局部修订。重写剧情、改变集数结构、扩写全文、全文翻译或调整整体风格等需求会被拒绝。

全局表同步更新：同步修订人物姓名、别名、身份描述、穿搭妆造、场景名、地点名、道具名称和道具描述等内容。

分集脚本联动修订：根据修订后的全局表和修改要求更新每集 Markdown 剧本，保持人物、场景和道具称谓一致。

结构化产物兼容：输入目录包含 structured/ 时，同步修订结构化分集文件；未包含时仅修订剧本和全局表。

修订结果交付：返回修订后三张全局表、分集剧本目录、可选结构化目录、可选全集脚本和差异文件目录。

支持的地域

北京：cn-beijing

上海：cn-shanghai

算子性能

细分项	限制或说明
最大 Submit RPM	600
最大 Poll RPM	600
最大并发度	10
耗时	受输入剧本集数、文本量、修改范围、结构化文件数量和模型处理耗时影响。

输入与输出要求

输入要求

细分项	详细要求
支持的数据模态	文本 JSON
输入模态：文本	输入为短剧剧本生成结果，其中分集剧本使用 Markdown 格式。修改要求（instruction）必须明确、局部且可替换，不支持重写剧情、改变集数、扩写全文、全文翻译或调整整体风格。
输入路径	仅支持 TOS 路径，格式为 tos://bucket/key 或 tos://bucket/prefix/。 TOS Bucket 须与 LAS 服务属于同一主账号、同一地域，并授予 LAS 输入对象或目录的读取权限。通过 input_tos_path 指定短剧剧本生成结果目录时：目录根层级需直接包含 character_table.json、scene_table.json、prop_table.json 和 scripts/ 分集脚本目录。三张全局表也兼容 final_character_table.json、final_scene_table.json 和 final_prop_table.json。无前缀文件与 final_ 前缀文件同时存在时，优先使用无前缀文件。目录包含 structured/ 时同步修订结构化分集文件；未包含时仅修订全局表和 Markdown 剧本。 input_tos_path 也可指向输入清单 JSON 文件。清单需包含人物表、场景表、道具表和非空分集脚本列表，具体结构见下文。

输出要求

细分项	详细要求
支持的数据模态	文本（Markdown） JSON
输出：文本	输出修订后的分集 Markdown 剧本。 script_type=full 时，额外输出全集脚本 scripts/full_script.md。输出 diffs/ 差异文件目录，便于核对修订前后的变化。
输出：JSON	输出修订后的人物表、场景表和道具表。输入包含结构化分集文件时，输出修订后的 structured/ 目录。 Poll 返回各产物路径、输入分集数量、输出分集数量和 Token 用量。
输出路径	通过 output_tos_path 指定 tos://bucket/prefix/ 格式的输出根目录，任务会在该目录下追加一级任务目录。 TOS Bucket 须与 LAS 服务属于同一主账号、同一地域，并授予 LAS 目标目录的写入权限。最终产物路径以 Poll 返回的 data 字段为准。

计费说明

计费标准

细分项	计费标准说明
计费项	包括模型输入、模型输出和缓存命中三个计费项。任务完成后，可通过 Poll 返回的 data.token_usage 查看 Token 用量。
计费类型	按量计费，单位为元/百万 Tokens，按实际用量计费。
单价	模型输入、模型输出和缓存命中分别按各自的实际计费用量与单价计算详情如下。

计费详情

计费项	计费项说明	单价
模型输入	非缓存命中的输入 Token	15 元/百万 Tokens
模型输出	输出 Token	75 元/百万 Tokens
缓存命中	命中缓存的输入 Token	3 元/百万 Tokens

注意与前提

细分项	注意与前提
开通 LAS	如果您是一个全新的火山引擎用户，此前未开通过 LAS 产品，可先开通 LAS。不使用 LAS 的计费功能，仅开通 LAS 产品不会产生费用。操作说明参见准备工作。开通完成后，可查看LAS 智能数据处理算子，了解算子能力和上手方式。
费用	调用算子前，请先了解模型调用费用。
鉴权（API Key）	调用算子前，需要生成算子调用 API Key。建议将 API Key 配置为环境变量，详情参见获取 API Key 并配置。
Base URL	调用算子前，需要根据当前 LAS 服务所在地域获取调用地址，详情参见获取 Base URL。下文以北京地域地址为例。

Rest API 调用

API 调用说明

本算子采用异步调用方式。先通过 Submit 接口提交任务并获取 task_id，再通过 Poll 接口查询任务状态和结果。

Submit

接口说明

提交短剧剧本局部修订任务。

请求参数

operator_id string 必选示例值: las_short_drama_script_revision

算子 ID，固定为 las_short_drama_script_revision。

operator_version string 必选示例值: v1

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

data ShortDramaScriptRevisionReqParams 必选

算子请求参数。

input_tos_path string 必选示例值: tos://bucket/path/script_gen_output

短剧剧本生成结果 TOS 目录，或输入清单 JSON 文件的 TOS 路径。必须以 tos:// 开头，输入内容要求参见本文“输入要求”。

instruction string 必选示例值: 把剧本里的英文专有名词改成对应音译后的中文

修订要求。应描述明确的局部替换或局部资产调整；空字符串或超出局部修订范围的要求会被拒绝。

output_tos_path string 必选示例值: tos://bucket/path/revision_output

修订结果输出根目录。任务会在该目录下追加一级任务目录。

script_type string Optional 示例值: full

输出脚本类型，默认为 full。full 会额外输出 scripts/full_script.md；compact 仅输出分集脚本。

输入清单 JSON 结构

character_table ManifestAsset 必选

人物表文件。

uri string 必选示例值: tos://example-bucket/script/character_table.json

人物表 JSON 的 TOS 路径。

scene_table ManifestAsset 必选

场景表文件。

uri string 必选示例值: tos://example-bucket/script/scene_table.json

场景表 JSON 的 TOS 路径。

prop_table ManifestAsset 必选

道具表文件。

uri string 必选示例值: tos://example-bucket/script/prop_table.json

道具表 JSON 的 TOS 路径。

scripts list of ManifestScript 必选

非空的分集脚本列表，数组顺序应与剧集顺序一致。

uri string 必选示例值: tos://example-bucket/script/scripts/ep_001.md

分集 Markdown 剧本的 TOS 路径。

episode_id string Optional 示例值: ep_001

分集标识，用于确定本地分集编号。

输入清单示例：

返回数据

metadata Metadata

请求元信息。

task_id string 示例值: task-20260724130000-abc123

异步任务 ID，用于通过 Poll 接口查询任务状态。

task_status string 示例值: PENDING

任务状态。支持 PENDING、RUNNING、COMPLETED、FAILED 和 TIMEOUT。

business_code string 示例值: 0

业务码。

error_msg string

异常信息，无异常时为空字符串。

示例

请求示例

以下示例使用短剧剧本生成结果目录作为输入，将人物名“杨萱萱”统一修改为“孙婉儿”。

返回示例

错误码

HttpStatusCode	错误码	错误信息	描述
400	Parameter.Invalid	invalid parameter	参数不合法，如 TOS 路径格式错误、instruction 为空，或其他入参越界。
400	Parameter.Missing	Missing required parameter	缺少必需参数，如缺少 input_tos_path 或 instruction；或指定 TOS 输入/输出时缺少对应凭证。
400	Tos.AccessFailed	Failed to access TOS path with provided credentials	TOS 路径访问失败或凭证无效。
400	DramaScriptRevision.InputMissing	missing required input file	输入目录缺少三张全局表或分集脚本目录，或输入清单缺少必需 URI。
400	DramaScriptRevision.ScopeRejected	revision scope rejected	修改要求不属于明确的局部修订，算子拒绝执行。
400	DramaScriptRevision.LLMFailed	LLM call failed during script revision	剧本修订过程中模型调用失败。
401	Authorization.Missing	Missing Authorization.	缺少鉴权。
401	ApiKey.InValid	The api key is invalid.	API Key 不合法。
500	InternalError	Internal error	服务内部错误。

Poll

接口说明

查询短剧剧本修订任务的执行状态和结果。

请求参数

operator_id string 必选示例值: las_short_drama_script_revision

算子 ID，固定为 las_short_drama_script_revision。

operator_version string 必选示例值: v1

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

task_id string 必选示例值: task-20260724130000-abc123

Submit 接口返回的任务 ID。

返回数据

metadata Metadata

请求元信息。

task_id string 示例值: task-20260724130000-abc123

异步任务 ID。

task_status string 示例值: COMPLETED

任务状态。支持 PENDING、RUNNING、COMPLETED、FAILED 和 TIMEOUT。

submit_time string 示例值: 2026-07-24T13:00:00+08:00

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

end_time string 示例值: 2026-07-24T13:07:05+08:00

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

business_code string 示例值: 0

业务码。

error_msg string

异常信息，无异常时为空字符串。

data ShortDramaScriptRevisionResponse Optional

task_status=COMPLETED 时返回修订结果。

output_dir string 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/

本次任务的实际输出目录。

package_url string or null Optional

可选的打包产物地址；未生成打包产物时为 null。

character_table_path string 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/character_table.json

修订后人物表 JSON 的 TOS 路径。

scene_table_path string 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/scene_table.json

修订后场景表 JSON 的 TOS 路径。

prop_table_path string 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/prop_table.json

修订后道具表 JSON 的 TOS 路径。

scripts_path string 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/scripts/

修订后分集 Markdown 剧本目录。

structured_path string Optional 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/structured/

修订后结构化分集目录。输入未包含结构化文件时可能为空。

full_script_path string Optional 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/scripts/full_script.md

script_type=full 时返回的全集脚本路径。

diffs_path string 示例值: tos://example-bucket/revision-output/task-20260724130000-abc123/diffs/

修订差异文件目录。

input_episode_count integer 示例值: 3

输入分集数量。

generated_script_count integer 示例值: 3

输出分集脚本数量。

token_usage TokenUsage

模型调用 Token 用量。

prompt_tokens integer 示例值: 10063

输入 Token 数。

completion_tokens integer 示例值: 681

输出 Token 数。

total_tokens integer 示例值: 10744

输入和输出 Token 总数。

cached_tokens integer 示例值: 0

命中缓存的输入 Token 数。

示例

请求示例

返回示例

错误码

HttpStatusCode	错误码	错误信息	描述
400	Parameter.Invalid	invalid parameter	参数不合法，如 task_id 为空或任务参数越界。
400	Parameter.Missing	Missing required parameter	缺少必需参数。
400	Tos.AccessFailed	Failed to access TOS path with provided credentials	TOS 路径访问失败或凭证无效。
400	DramaScriptRevision.InputMissing	missing required input file	输入目录缺少三张全局表或分集脚本目录，或输入清单缺少必需 URI。
400	DramaScriptRevision.ScopeRejected	revision scope rejected	修改要求不属于明确的局部修订，算子拒绝执行。
400	DramaScriptRevision.LLMFailed	LLM call failed during script revision	剧本修订过程中模型调用失败。
401	Authorization.Missing	Missing Authorization.	缺少鉴权。
401	ApiKey.InValid	The api key is invalid.	API Key 不合法。
500	InternalError	Internal error	服务内部错误。

AI 数据湖服务