短剧/电影剧本生成算子(las_short_drama_script_gen)是面向短剧以及长视频/电影等连载或超长视频内容的自动化剧本逆向提取工具。算子依托视觉多模态大模型(VLM),能够自动提取全剧/全片角色、分析人物关系,并基于画面与台词逆向生成包含场景、动作、神态及对话等细节的高质量文本剧本和角色表,助力视频内容的二次创作、出海翻译与版权保护。
算子 ID:las_short_drama_script_gen
场景 | 描述 |
|---|---|
短剧出海与本土化翻译 | 自动化生成原片多维度文本底稿,降低人工扒稿成本。 |
影视内容二次创作 | 提供高颗粒度的剧情文本和角色特征,便于二创文案撰写。 |
版权保护与侵权比对 | 视频内容的高保真文本化,固定证据链。 |
细分项 | 性能影响说明 |
|---|---|
耗时 |
|
细分 | 详细要求 |
|---|---|
支持的输入数据模态 |
|
输入格式:视频 |
|
输入路径要求 | 通过请求参数
|
细分 | 详细要求 |
|---|---|
输出数据模态 |
|
输出路径:TOS | 通过请求参数
|
计费标准
细分项 | 计费标准说明 |
|---|---|
计费项 | 基于输入视频的时长统计用量,并进行计费。 |
计费类型 | 按量计费,单位: |
单价 | 1.5 元/分钟 |
计费详情
计费公式:总费用 = 单价 * 用量
细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
提交 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)。 |
custom_script_prompt | string | 否 | 自定义剧本生成 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" } }'
{ "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 | 任务状态。
|
business_code | string | ApiKey.InValid | 业务码。 |
error_msg | string | The api key is invalid. | 如有异常,会返回详细的异常信息。 |
task_id | string | task-xxx | 异步模式下的任务 ID。 |
data | ShortDramaGenResponse | 返回的数据。 | |
final_table_path | string | tos://bucket/key | 最终角色表路径。 |
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列表。 |
status | string | success | 短剧生成状态,枚举值:success、failed、partial_success。 |
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", "business_code": "0", "error_msg": "Task processed successfully" }, "data": { "final_table_path": "tos://xxx/final_character_table.json", "scripts_path": "tos://xxx/scripts", "package_url": null, "input_episode_count": 12, "generated_script_count": 12, "total_video_duration_minutes": 27.8, "failed_video_urls": [], "status": "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. | 服务内部错误 |