短剧/电影剧本生成算子(las_short_drama_script_gen)是面向短剧以及长视频/电影等连载或超长视频内容的自动化剧本逆向提取工具。算子依托视觉多模态大模型(VLM),能够自动提取全剧/全片角色、分析人物关系,并基于画面与台词逆向生成包含场景、动作、神态及对话等细节的高质量文本剧本和角色表,助力视频内容的二次创作、出海翻译与版权保护。
算子 ID:las_short_drama_script_gen
场景 | 描述 |
|---|---|
短剧出海与本土化翻译 | 自动化生成原片多维度文本底稿,降低人工扒稿成本。 |
影视内容二次创作 | 提供高颗粒度的剧情文本和角色特征,便于二创文案撰写。 |
版权保护与侵权比对 | 视频内容的高保真文本化,固定证据链。 |
细分项 | 性能影响说明 |
|---|---|
最大 RPM | 600 |
最大并发数 | 10 |
耗时 |
|
细分 | 详细要求 |
|---|---|
支持的输入数据模态 |
|
输入格式:视频 |
|
输入路径要求 | 通过请求参数
|
细分 | 详细要求 |
|---|---|
输出数据模态 |
|
输出路径:TOS | 通过请求参数
|
计费标准
细分项 | 计费标准说明 |
|---|---|
计费项 | 基于输入视频的时长统计用量,并进行计费。 |
计费类型 | 按量计费,单位: |
单价 | 1.5 元/分钟 |
计费详情
计费公式:总费用 = 单价 * 用量
细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
Submit 接口提交任务获得任务的 task_id,再通过 Poll 接口获取对应任务(task_id)运行状态,并获取算子处理结果。task_id 有效期为 3 天,超过 3 天后即无法通过此 task_id 来获取算子处理结果。提交 las_short_drama_gen 算子进行短剧/电影剧本生成任务。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_short_drama_script_gen | 本算子的id是 las_short_drama_script_gen。 |
operator_version | string | 是 | v1 | 目前只支持v1。 |
data | ShortDramaScriptGenReqParams | 是 | 算子参数。 | |
video_urls | list of string | 是 | [tos://xxx/video.mp4] | 短剧视频(电影)URL 列表,后台自动识别短剧和电影模式。注意:算子将严格按照列表的物理索引顺序判定剧集序号(即第一个 URL 默认为第 1 集,以此类推),请务必在传入前确保列表已按剧集顺序正确排列。支持火山 TOS(tos://bucket/key)。 |
output_tos_path | string | 是 | tos://testbucket/path/ | 结果保存的 TOS 路径。支持火山 TOS(tos://bucket/key)。 |
out_script_language | string | 否 | zh | 输出剧本语言。默认值为 zh,可选值:zh、en。 |
custom_script_prompt | string | 否 | 自定义剧本生成 Prompt。 | |
generate_asset_images | boolean | 否 | false | 是否为最终人物表、场景表和道具表生成代表截图。默认值为 false,即关闭;设置为 true 时,仅在未传入 custom_script_prompt 的默认主流程中生效。截图生成失败不会阻塞剧本和三表交付。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求元信息。 | |
task_id | string | task-xxx | 异步模式下的任务 ID,用于作业状态查询。 |
task_status | string | PENDING | 异步模式下的任务状态。
|
business_code | string | 0 | 业务码。 |
error_msg | string | 如有异常,会返回详细的异常信息。 |
# 请将 INPUT_PATH 设置为 保存在本账号下的视频文件TOS路径 export INPUT_PATH="tos://xxxx/sample.mp4" # 请将 OUTPUT_PATH_TEMPLATE 设置为本账号上可写入的tos路径 export OUTPUT_PATH_TEMPLATE="tos://xxxx/output/" # 发起算子服务请求 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_gen", "operator_version": "v1", "data": { "video_urls": ["$INPUT_PATH"], "output_tos_path": "$OUTPUT_PATH_TEMPLATE", "out_script_language": "zh", "generate_asset_images": true } }'
{ "metadata": { "task_id": "task-20251125163544-abc123", "task_status": "PENDING", "business_code": "0", "error_msg": "" } }
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | Parameter.Invalid | The parameter is invalid.. | 参数不合法 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权 |
401 | ApiKey.InValid | The api key is invalid. | API不合法 |
查询短剧/电影剧本生成任务的执行状态和结果。
参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|
operator_id | string | 是 | las_short_drama_script_gen | 算子 ID |
operator_version | string | 是 | v1 | 算子版本 |
task_id | string | 是 | task-xxx | 任务 ID |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求的元信息。 | |
task_status | string | COMPLETED | 任务状态。
|
submit_time | string | 2026-07-21T16:04:06+08:00 | 任务提交时间,格式为 ISO 8601 时间戳。 |
end_time | string | 2026-07-21T16:04:06+08:00 | 任务结束时间,格式为 ISO 8601 时间戳。 |
business_code | string | 0 | 业务码。 |
error_msg | string | The api key is invalid. | 如有异常,会返回详细的异常信息。 |
task_id | string | task-xxx | 异步模式下的任务 ID。 |
data | ShortDramaGenResponse | 返回的数据。 | |
final_table_path | string | tos://bucket/key | 最终角色表JSON路径。 |
final_scene_table_path | string | tos://bucket/key | 最终场景表JSON路径。 |
final_prop_table_path | string | tos://bucket/key | 最终道具表JSON路径。 |
scripts_path | string | tos://bucket/key | 剧本文件夹路径。 |
input_episode_count | integer | 2 | 输入的剧集总数。 |
generated_script_count | integer | 2 | 成功生成的剧本数量。 |
total_video_duration_minutes | float | 16.6 | 成功处理的视频总时长(分钟)。 |
failed_video_urls | list of string | ["tos://bucket/key"] | 处理失败的视频URL列表。 |
failed_videos | list of FailedVideoInfo | [{"video_url":"tos://bucket/key.mp4","episode_index":1,"reason":"Unsupported video format"}] | 处理失败的视频详情列表,包含失败视频 URL、剧集序号和失败原因。 |
video_url | string | tos://bucket/key.mp4 | 处理失败的视频 URL。 |
episode_index | integer | 1 | 失败视频对应的剧集序号,从 1 开始。 |
reason | string | Unsupported video format | 失败原因。 |
status | string | success | 短剧生成状态,通常在 metadata.task_status=COMPLETED 时返回,枚举值:success、failed、partial_success。partial_success 表示任务整体完成但存在部分视频处理失败,此时 failed_video_urls 非空且 generated_script_count 小于 input_episode_count;failed 所有视频生成失败。 |
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_gen", "operator_version": "v1", "task_id": "task-20251125163544-abc123" }'
{ "metadata": { "task_id": "06ecbd66031e7006022d", "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": "Task processed successfully" }, "data": { "final_table_path": "tos://xxx/final_character_table.json", "final_scene_table_path": "tos://xxx/final_scene_table.json", "final_prop_table_path": "tos://xxx/final_prop_table.json", "scripts_path": "tos://xxx/scripts", "input_episode_count": 12, "generated_script_count": 9, "total_video_duration_minutes": 27.8, "failed_video_urls": [], "failed_videos": [], "status": "partial_success" } }
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
400 | Parameter.Missing | Missing required parameter. | 请求体中缺少必须的参数 |
400 | Parameter.Invalid | Invalid parameter. | 参数不合法 |
400 | Url.Invalid | Invalid URL. | 视频 URL 无法访问或不存在 |
400 | Video.Invalid | Invalid video file. | 视频格式不支持或文件损坏 |
400 | Video.DownloadFailed | Video download failed. | 下载异常或访问失败 |
400 | Image.TooLarge | Video file too large. | 视频文件体积超出了系统单次处理上限 |
400 | Video.DurationExceeded | Video duration exceeded. | 视频总时长超过了最大限制 |
400 | Video.DurationTooShort | Video duration too short. | 视频时长不足以进行剧情还原 |
400 | Video.FrameExtractionFailed | Frame extraction failed. | 帧提取失败 |
400 | Connection.TooMany | Exceed max connections. | 并发过高触发了限流 |
400 | Video.VLMFailed | VLM call failed. | 模型请求失败 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权 |
401 | ApiKey.InValid | The api key is invalid. | API不合法 |
400 | Task.NotFound | Task not found. | 任务不存在 |
500 | Internal.ServerError | Internal server error. | 服务内部错误 |