短剧剧本修订算子面向短剧剧本生成结果，根据明确的局部修改要求，同步修订人物表、场景表、道具表、分集剧本和可选的结构化分集文件，并将修订结果及差异文件写入 TOS。 # 算子介绍 > 算子 ID：`las_short_drama_script_revision` ## 适用场景 * **名称替换**：修改人物名、别名、组织名、地点名或专有名词译名。 * **资产描述调整**：调整人物身份与穿搭妆造、场景描述、道具名称或道具外观。 * **局部文本清理**：删除或替换剧本和资产表中的残留词、错误称谓或不一致表达。 * **本地化返修**：统一修改专有名词表达，同时保留无需改写的普通业务术语。 * **生成后返修**：在短剧剧本生成结果基础上做小范围修改，避免重新生成整部短剧。 ## 核心能力 * **生成结果目录修订**：读取短剧剧本生成算子产出的 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 产品不会产生费用。操作说明参见[准备工作](https://docs.volcengine.com/docs/6492/1264537)。

* 开通完成后，可查看[LAS 智能数据处理算子](https://docs.volcengine.com/docs/6492/1798368)，了解算子能力和上手方式。 | |费用 |调用算子前，请先了解模型调用费用。 | |鉴权（API Key） |调用算子前，需要生成算子调用 API Key。建议将 API Key 配置为环境变量，详情参见[获取 API Key 并配置](https://docs.volcengine.com/docs/6492/2191994)。 | |Base URL |调用算子前，需要根据当前 LAS 服务所在地域获取调用地址，详情参见[获取 Base URL](https://docs.volcengine.com/docs/6492/2191993)。下文以北京地域地址为例。 | # 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` 分集标识，用于确定本地分集编号。输入清单示例： ```json { "character_table": { "uri": "tos://example-bucket/script/character_table.json" }, "scene_table": { "uri": "tos://example-bucket/script/scene_table.json" }, "prop_table": { "uri": "tos://example-bucket/script/prop_table.json" }, "scripts": [ { "uri": "tos://example-bucket/script/scripts/ep_001.md", "episode_id": "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 异常信息，无异常时为空字符串。 ### 示例 #### 请求示例以下示例使用短剧剧本生成结果目录作为输入，将人物名“杨萱萱”统一修改为“孙婉儿”。 ```bash export INPUT_TOS_PATH="tos://example-bucket/script-gen-output/" export OUTPUT_TOS_PATH="tos://example-bucket/revision-output/" curl --location "https://las.cn-beijing.volces.com/api/v1/submit" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer $LAS_API_KEY" \ --data @- <

AI 数据湖服务