短剧剧本解析算子用于将短剧剧本文本自动转化为结构化资产表。算子会读取一个或多个剧本文件,自动识别剧本格式与输出语言,提取人物、道具、场景三类资产,并通过视觉扩写补充人物外观、人物造型、道具视觉描述和场景空间描述,最终将结果保存为 JSON 文件。
算子ID:las_short_drama_script_parse
auto 模式下自动识别剧本格式并决定资产表输出语言。支持输入多集剧本,以下为两个输入示例
细分项 | 性能影响说明 |
|---|---|
最大 RPM | 600 |
最大并发数 | 10 |
细分 | 详细要求 |
|---|---|
输入数据模态 |
|
输入格式:文本 |
|
输入路径要求 | 通过请求参数
|
细分 | 详细要求 |
|---|---|
输出数据模态 |
|
输出路径:TOS | 您可通过请求参数
|
输出路径:预签名 URL | 如果您没有配置 |
计费标准
细分项 | 计费标准说明 |
|---|---|
计费项 | 包括2个计费项:模型输入、模型输出。需支付的费用为所有计费项的计费之和。
|
计费类型 | 按量计费,单位: |
单价 | 模型输入、模型输出的单价不同。
|
细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
提交 las_short_drama_script_parse 算子进行短剧剧本解析任务。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_short_drama_script_parse | 算子 ID。 |
operator_version | string | 是 | v1 | 算子版本,目前仅支持 v1。 |
data | ShortDramaScriptParseReqParams | 是 | 算子参数。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求元信息。 |
请求示例
# 请将 INPUT_PATH 设置为可访问的剧本文件路径 export INPUT_PATH="tos://bucket/scripts/demo_script.md" # 请将 OUTPUT_PATH 设置为可写入的 TOS 输出目录 export OUTPUT_PATH="tos://bucket/output/script_parse/" 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_short_drama_script_parse", "operator_version": "v1", "data": { "script_urls": ["$INPUT_PATH"], "output_tos_path": "$OUTPUT_PATH" } }'
返回示例
{ "metadata": { "task_id": "task-20260724130000-abc123", "task_status": "PENDING", "business_code": "0", "error_msg": "" } }
HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | Parameter.Invalid | invalid parameter | 参数不合法,如 |
400 | Parameter.Missing | Missing required parameter | 缺少必需参数,如缺少 |
400 | Tos.AccessFailed | Failed to access TOS path with provided credentials | TOS 路径访问失败或凭证无效。 |
400 | DramaScript.Invalid | invalid drama script | 剧本文件无效,如非 UTF-8 文本、内容为空或无法解析。 |
400 | DramaScript.NoBeat | no valid beat found in drama script | 未从剧本中识别到有效场次(beat)。 |
400 | DramaScript.ExtractEmpty | script asset extraction returned empty result | 资产抽取结果为空,未提取到人物/道具/场景。 |
400 | DramaScript.LLMTruncated | LLM output was truncated | 模型输出被截断( |
400 | DramaScript.LLMFailed | LLM call failed during drama script parsing | 剧本解析过程中模型调用失败。 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权。 |
401 | ApiKey.InValid | The api key is invalid. | API Key 不合法。 |
500 | InternalError | Internal error | 服务内部错误。 |
查询短剧剧本解析任务的执行状态和结果。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_short_drama_script_parse | 算子 ID。 |
operator_version | string | 是 | v1 | 算子版本。 |
task_id | string | 是 | task-xxx | Submit 接口返回的任务 ID。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求元信息。 | |
data | ShortDramaScriptParseResponse | task_status 为 COMPLETED 时返回解析结果。 |
请求示例
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_short_drama_script_parse", "operator_version": "v1", "task_id": "task-20260724130000-abc123" }'
返回示例
{ "metadata": { "task_id": "task-20260724130000-abc123", "task_status": "COMPLETED", "submit_time": "2026-07-21T16:04:06+08:00", "end_time": "2026-07-21T16:04:06+08:00", "business_code": "0", "error_msg": "" }, "data": { "script_char_count": 60702, "character_count": 6, "prop_count": 5, "scene_count": 10, "artifacts": { "character_table_path": "tos://bucket/output/character_table.json", "prop_table_path": "tos://bucket/output/prop_table.json", "scene_table_path": "tos://bucket/output/scene_table.json", "script_context_path": "tos://bucket/output/script_context.json" }, "token_usages": [ { "token_usage": { "prompt_tokens": 100000, "completion_tokens": 20000, "total_tokens": 120000 } } ] } }
HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | Parameter.Invalid | invalid parameter | 参数不合法,如 |
400 | Parameter.Missing | Missing required parameter | 缺少必需参数,如缺少 |
400 | Tos.AccessFailed | Failed to access TOS path with provided credentials | TOS 路径访问失败或凭证无效。 |
400 | DramaScript.Invalid | invalid drama script | 剧本文件无效,如非 UTF-8 文本、内容为空或无法解析。 |
400 | DramaScript.NoBeat | no valid beat found in drama script | 未从剧本中识别到有效场次(beat)。 |
400 | DramaScript.ExtractEmpty | script asset extraction returned empty result | 资产抽取结果为空,未提取到人物/道具/场景。 |
400 | DramaScript.LLMTruncated | LLM output was truncated | 模型输出被截断( |
400 | DramaScript.LLMFailed | LLM call failed during drama script parsing | 剧本解析过程中模型调用失败。 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权。 |
401 | ApiKey.InValid | The api key is invalid. | API Key 不合法。 |
500 | InternalError | Internal error | 服务内部错误。 |
输入剧本的内容,每场剧本内容必须包含独立的场次标记行,基本格式为:
X-Y 场次描述
该格式不限制正文语言。中文和英文剧本均可使用,例如 1-1 日 外 秦岭山中 和 1-1 INT. OFFICE - DAY 都可以被识别。
X 表示集号,Y 表示该集内的场次号,分别由 1~3 位数字组成。- 或下划线 _。1 - 2。1-1 日 外 山中;编号单独成行时可直接换行。#、##、###、场号: 或 场号:,例如 ### 1-1 日 外 山中。# 第 1 集剧本 ## 正文剧本 ## 1-1 内景 航空管制中心大厅 日 出场人物:苏星晚、陆霆川 △ 冷光灯照亮航空管制中心大厅,墙面上的多块监测屏幕显示着航班轨迹、气象雷达等信息,苏星晚身着藏青色空管制服坐在管制台的黑色办公椅上,视线看向前方屏幕。 苏星晚(神色严肃):中南8562,前方两公里强雷雨回波,立即右转航道120,否则有坠毁风险! ……
英文剧本既可以使用上文的 X-Y 集-场编号格式,也可以通过 Hollywood/Fountain slug line 识别场次。
INT.、EXT.、EST.、I/E.、INT./EXT. 和 EXT./INT.。EPISODE 1、EP. 2、EP 3 等分集标题。EPISODE 1 INT. COFFEE SHOP - DAY Sarah sits beside the window, holding a red notebook. SARAH We need to leave before noon. EXT./INT. CAR - NIGHT John starts the engine and checks the rear-view mirror.
算子处理完成任务后,会生成人物、道具、场景、剧本背景资产表。对应表字段说明如下。
字段名 | 人物资产表 | 道具资产表 | 场景资产表 |
|---|---|---|---|
| 人物在当前表内的唯一标识 | 道具在当前表内的唯一标识 | 场景在当前表内的唯一标识 |
| 人物名称 | 道具名称 | 场景名称 |
| 人物性别 | 不涉及 | 不涉及 |
| 不涉及 | 不涉及 | 场景所属的粗粒度大地点 |
| 人物基础外貌形象描述 | 道具外形特征/基础常态描述 | 场景环境、空间结构、视觉布置等描述 |
| 人物服装、妆造、年龄阶段等造型描述 | 道具状态变化描述 | 场景时段/状态/氛围变体描述 |
| 人物出现的场次编号,格式 | 道具出现的场次编号,格式 | 场景出现的场次编号,格式 |
| 人物总数 | 道具总数 | 场景总数 |
| schema 版本 | schema 版本 | schema 版本 |