You need to enable JavaScript to run this app.
文档中心
AI 数据湖服务

AI 数据湖服务

复制全文
下载 pdf
视频分析
短剧剧本生成
复制全文
下载 pdf
短剧剧本生成

短剧/电影剧本生成算子(las_short_drama_script_gen)是面向短剧以及长视频/电影等连载或超长视频内容的自动化剧本逆向提取工具。算子依托视觉多模态大模型(VLM),能够自动提取全剧/全片角色、分析人物关系,并基于画面与台词逆向生成包含场景、动作、神态及对话等细节的高质量文本剧本和角色表,助力视频内容的二次创作、出海翻译与版权保护。

算子介绍

算子 ID:las_short_drama_script_gen

适用场景

场景

描述

短剧出海与本土化翻译

自动化生成原片多维度文本底稿,降低人工扒稿成本。

影视内容二次创作

提供高颗粒度的剧情文本和角色特征,便于二创文案撰写。

版权保护与侵权比对

视频内容的高保真文本化,固定证据链。

核心能力

  • 角色一致性识别:突破单集、单片段孤立理解的局限,能够在长篇连载或超长电影中稳定追踪核心角色。在面临换装、侧脸或复杂场景切换时,保障跨集人物身份与设定的高度一致,最终构建完整的全局角色表。
  • 高保真剧本逆向还原:结合视频画面与对白台词,逆向输出专业级分镜剧本(电影模式下带有精确时间戳)。精细还原场景布置、人物情绪、肢体动作以及关键对白,提供可以直接投入二次开发或翻译校对的高质量文本底稿。
  • 双模式自适应架构
    • 短剧模式:支持批量传入多集短剧列表,严格按照输入顺序处理,保持连载剧情的连贯性与角色一致性。
    • 电影模式:针对单集数小时的电影或长录像,自动启动长视频自适应处理策略,有效缓解大模型长上下文带来的细节遗忘问题。
  • 灵活的输出格式定制:提供开放的自定义指令(Prompt)接口。您可以根据具体的业务要求(如:侧重心理描写、特定的分镜排版格式、特定的文本标记等)自由调整单集剧本的生成样式,满足不同下游业务的直接对接需求。
  • 便捷的结果交付:支持将生成的角色表与全集剧本直接安全地写入您指定的云端存储(TOS)。

效果展示


【输入视频】
  • 输入视频:EP01
  • 输入视频:EP02

【输出结果】
  • 示例1:使用默认剧本格式
    • 全局角色表
      final_character_table.json
      未知大小
    • 分集剧本EP 01
      Image
      ep_001.md
      未知大小
    • 分集剧本EP 02
      Image
      ep_002.md
      未知大小
  • 示例2:通过自定义Prompt设置剧本生成格式
    • 自定义Prompt示例
      Prompt.sh
      未知大小
    • 分集剧本EP 01
      Image
      ep_001.md
      未知大小
    • 分集剧本EP 02
      Image
      ep_002.md
      未知大小

支持的地域

  • 北京:cn-beijing
  • 上海:cn-shanghai
  • 广州:cn-guangzhou

算子性能

细分项
性能影响说明

耗时

  • 与视频时长正相关。

输入与输出要求

输入要求

细分

详细要求

支持的输入数据模态

  • 视频

输入格式:视频

  • 格式:mp4movavimkvflvwebm
  • 大小:最短 1 秒,最长 5 小时;最大 10 GB。

输入路径要求

通过请求参数 video_urls 提供给算子输入数据,当前支持公网 URL、TOS 路径这两种方式。

  • 公网 URL:公网可访问的 URL,格式为 http/https
    • 公网 URL 不支持需要登录态或额外 Header 鉴权的地址;临时 URL 需在任务执行期间有效。
  • TOS 路径:将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后,可提供 TOS 路径,格式为tos://bucket_name/demo
    • TOS 对象需存在且具备读取权限。

输出要求

细分

详细要求

输出数据模态

  • 文本(剧本 Markdown 文件)

输出路径:TOS

通过请求参数output_tos_path 指定算子输出结果的存储路径,当前支持设置为 TOS 路径。

  • TOS 路径:与LAS服务同主账号、同地域下,有可写权限的 TOS Bucket 目录,格式:tos://bucket/output/

计费说明
  • 计费标准

    细分项
    计费标准说明

    计费项

    基于输入视频的时长统计用量,并进行计费。

    计费类型

    按量计费,单位:元/分钟,按实际的计费用量每小时出账。

    单价

    1.5 元/分钟

  • 计费详情
    计费公式:总费用 = 单价 * 用量

注意与前提

细分项

注意与前提

开通 LAS

  • 如果您是一个全新的火山引擎用户,此前未开通过 LAS 产品,您可先开通 LAS,不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作
  • 开通完成后可查看算子介绍文档,了解算子能力、上手引导等,详情可参见:LAS 智能数据处理算子

费用

调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费

鉴权(API Key)

调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置

BaseURL

调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。
详情请参见获取 Base URL,下文中的调用示例仅作为参考,实际调用时需替换为您对应地域的路径取值。

Rest API 调用

submit

接口说明

提交 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
异步模式下的任务状态。
  • PENDING, 接收请求
  • RUNNING, 正在运行
  • COMPLETED, 已经完成
  • FAILED, 失败
  • TIMEOUT, 超时
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不合法

Poll

接口说明

查询短剧/电影剧本生成任务的执行状态和结果。

请求参数

参数

类型

必填

示例值

说明

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
任务状态。
  • ACCEPTED, 接收到请求
  • RUNNING, 正在运行
  • COMPLETED, 已经完成
  • FAILED, 失败
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.

服务内部错误

最近更新时间:2026.06.24 14:31:54
这个页面对您有帮助吗?
有用
有用
无用
无用