视频提示词逆向生成算子面向视频复刻和分镜再创作场景。算子先理解源视频事实，再结合分镜资产包中的时间范围和参考图片，输出逐片段、可执行的视频生成 Prompt。推荐直接传入“视频分镜”算子返回的 storyboard_bundle_url；只有在自行构造或编辑分镜时，才需要直接传入分镜数组。

算子介绍

核心功能

基于源视频事实和分镜时间窗逐段生成 Prompt，避免跨片段混入内容。

保留已验证的主体身份、空间关系、关键动作顺序、原声台词和声音表现。

支持在不改变源视频事实的前提下指定目标视觉风格和目标音色。

支持在分镜中绑定参考图片，并在生成结果中返回对应引用；参考素材名称唯一性范围（reference_name_scope）默认按整任务处理，也可改为按单个分镜处理，同名引用的后缀会与 Prompt 中的 @名称同步。

返回模型请求次数、总 Token 用量及用量是否完整。

推荐：使用分镜资产包

直接使用“视频分镜”算子返回的 storyboard_bundle_url。该值必须是 storyboard_bundle_manifest.json 的完整文件 URI，支持有效的预签名 HTTPS URL；不能传目录，也不能用 segments_url 或 shot_registry_url 代替。模型选择字段可省略，默认使用 pro。

模型选择

lite	standard	pro	已验证的 model_name 示例
doubao-seed-2-0-lite-260428	doubao-seed-2-1-turbo-260628	doubao-seed-2-1-pro-260915	三个档位模型，以及 doubao-seed-2-0-mini-260428、doubao-seed-2-1-pro-260628、doubao-seed-2-1-lite-260915

模型选择只影响第二阶段 Prompt 生成；第一阶段事实提取始终使用当前地域配置的 Lite 模型。推荐使用 model_tier；需要固定版本时可传非空 model_name，服务会将其原样传给方舟。两者不能同时传入。示例列表不是准入白名单；提交前请确认模型在当前地域可用且方舟 API Key 有权访问。模型不存在、地域不可用或 API Key 无权访问时由方舟返回失败；服务不降级、不自动重试。

Prompt 模板选择

prompt_profile	适用场景
general	通用视频复刻与再创作；不确定时使用此模板
beauty	美妆、护肤和个护商品内容，侧重产品展示、人物状态与使用动作
home_textile	家纺内容，侧重面料质感、结构、褶皱和接触关系

模板只调整输出 Prompt 的行业表达重点。主体、场景、动作、台词等事实仍以源视频和分镜输入为准。

支持的地域

北京：cn-beijing

上海：cn-shanghai

广州：cn-guangzhou

算子性能

细分项	详细要求
Submit RPM	200
Poll RPM	300

输入与输出要求

输入要求

细分项	详细要求
支持的输入数据模态	视频图片文本
输入格式：视频	原视频实测时长须大于 0 且不超过 360 秒。内联分镜最多 24 个；时间窗支持小数，须在源视频内按顺序且不重叠。
输入格式：图片	每个分镜的参考图片无 9 张上限；ID 在分镜内唯一，位置须从 1 开始连续递增。下游视频生成仍有独立限制。
输入格式：文本	大小：Storyboard bundle manifest 及其引用的单个 JSON 文件不超过 2 MiB。
输入路径要求	通过 source_video_url、storyboard_bundle_url 等请求参数提供算子所需的输入数据，支持可访问的 TOS、HTTP 或 HTTPS 地址，包括有效的预签名地址。预签名地址的签名参数必须完整保留，并在任务处理期间有效；服务不会刷新已过期的签名。 TOS 对象需与当前 LAS 服务同主账号、同地域，且具备读取权限。

输出要求

细分项	详细要求
支持的输出数据模态	文本
输出格式：文本	按输入分镜顺序返回逐分镜视频 Prompt，并返回每个分镜绑定的参考图片。输出语言：output_language 支持 zh 和 en，默认 zh，兼容 zh-CN、en-US、en_GB 等语言地区别名；原声台词保持原语言。
输出方式	任务完成后通过 Poll 接口的 data.items 返回结果。

算子定价

调用时需要设置有效的方舟 API Key，具体费用以实际模型用量为准。

注意与前提

开通方舟

本算子需调用您自己开通的方舟模型，账单也出具在您自己的方舟模型账单下。因此，在使用算子前需先开通方舟模型并获取 ark_api_key；第二阶段模型可通过档位或当前地域支持的精确模型名选择。

通用注意

细分项	注意与前提
开通 LAS	如果您是一个全新的火山引擎用户，此前未开通过 LAS 产品，您可先开通 LAS，不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作。开通完成后可查看算子介绍文档，了解算子能力、上手引导等，详情可参见：LAS 智能数据处理算子。
费用	调用算子前，您需先了解使用算子时的模型调用费用，详情请参见大模型调用计费。
鉴权（API Key）	调用算子前，您需要先生成算子调用的API Key，并建议将API Key配置为环境变量，便于更安全地调用算子，详情请参见获取 API Key 并配置。
BaseURL	调用算子前，您需要先根据您当前使用的LAS服务所在地域，了解算子调用的BaseURL，用于配置算子调用路径参数取值。详情请参见获取 Base URL，下文中的调用示例仅作为参考，实际调用时需替换为您对应地域的路径取值。

Rest API 调用

Submit

接口说明

提交视频提示词逆向生成异步任务。

请求头使用 Authorization: Bearer <LAS_API_KEY> 用于 LAS 服务鉴权；请求体中的 ark_api_key 必须是有效的方舟 API Key。第一阶段固定使用 Lite 模型提取源视频事实，model_tier 或 model_name 只选择第二阶段的 Prompt 生成模型。

成功后返回任务 ID，可通过 Poll 查询逐分镜 Prompt。

Bundle 包含 episode 时，以 source_video_url 唯一匹配源视频，使用该 episode 的局部时间窗，并优先以 global_segment_id 关联分镜。无匹配、多重匹配或 segments/shots 的 episode 不一致会失败；一次请求不混合多个源视频。

预签名地址的签名参数必须完整保留，并在处理期间保持可访问。manifest、其引用的 JSON、源视频和参考图片均适用；已知过期或无效的签名会失败，无法访问时请获取新地址后重提，服务不会刷新签名。

多个分镜的时间范围必须按时间单调排列且互不重叠。旧分镜的 video_url 不决定处理视频，实际按 source_video_url 和时间窗裁片；不要依赖它覆盖源视频。取消参考图数量和片段时长限制仅适用于本逆推算子；下游视频生成仍需遵守自己的输入限制。

请求参数

operator_id string 必选示例值: las_viral_reverse_prompt

算子 ID

operator_version string 必选示例值: v1

算子版本

data ViralReversePromptInfo 必选

视频逆向 Prompt 参数

storyboard_bundle_url string Optional 示例值: tos://bucket/storyboard/storyboard_bundle_manifest.json

条件必选。推荐直接使用“视频分镜”算子 Poll 结果中的 data.storyboard_bundle_url。须传 manifest 完整文件 URI，支持有效的预签名 HTTPS URL；不能传目录，也不能用 segments_url 或 shot_registry_url 代替

source_video_url string 必选示例值: tos://bucket/source.mp4

必须与分镜对应同一源视频；支持 tos://、http://、https://，包括有效的预签名 URL。实测时长须大于 0 且不超过 360 秒

ark_api_key string 必选示例值: <YOUR_ARK_API_KEY>

有效的方舟 API Key

prompt_profile string Optional 示例值: general

Prompt 模板：general（通用）、beauty（美妆）或 home_textile（家纺），默认 general。模板决定输出 Prompt 的行业侧重点，但不会改变源视频中的主体、动作、台词等事实

output_language string Optional 示例值: zh

Prompt 说明文字语言，zh 或 en，默认 zh；兼容 zh-CN、en-US、en_GB 等语言地区别名。原声台词保持原语言

reference_name_scope string Optional 示例值: task

参考素材名称唯一性范围，可选 task（整任务）或 segment（单分镜），默认 task。该设置作用于本次请求的全部分镜，适用于 Bundle 和内联分镜；显式传入 null、空字符串、其他值或非字符串会返回 Parameter.Invalid

model_tier string Optional 示例值: pro

推荐的第二阶段模型选择方式，可选 lite、standard、pro，默认 pro

model_name string Optional 示例值: doubao-seed-2-0-mini-260428

高级精确模型选择，只影响第二阶段。服务将非空模型名原样传给方舟；请确保模型在当前地域可用且方舟 API Key 有权访问。与 model_tier 不能同时传入

video_style string Optional 示例值: 电影感暖色调

目标视觉风格，去除首尾空白后最长 1000 个字符；只改变表现方式，不改变源视频事实

voice_style string Optional 示例值: 沉稳自然的成年女声

已有真人语音的目标音色，去除首尾空白后最长 1000 个字符；不会新增台词或说话人

storyboard_segments list of StoryboardSegment Optional

条件必选。没有 bundle 或需要提交自行编辑的分镜时使用，包含 1～24 个分镜；单分镜也使用长度为 1 的数组。与 storyboard_bundle_url 二选一

segment_id string 必选示例值: segment-001

当前请求内唯一的分镜 ID

source_segment_id string Optional 示例值: source-segment-001

源分镜追踪 ID，可由多个分镜复用；省略时使用 segment_id

visual_description string Optional 示例值: 银色咖啡机在清晨厨房完成研磨和萃取

兼容旧分镜元数据，可省略、传 null 或空字符串；生成以源视频时间窗内的实际画面为准

start_time float 必选示例值: 0

源视频开始秒数，须为有限数值且大于等于 0，支持小数

end_time float 必选示例值: 8

源视频结束秒数，须为有限数值且大于 start_time；不再单独限制片段为 4～30 秒。分镜须按时间排序且不重叠。结束时间超过实测源视频时长不超过 0.1 秒、且开始仍在源片内时，裁剪到片尾；超出更多或整个分镜位于片外仍失败

references list of ReversePromptReference Optional

当前分镜的参考图片，无 9 张数量上限；仍须满足 ID 唯一和位置连续等约束

reference_id string 必选示例值: product-1

当前分镜内唯一的参考图片 ID

position integer 必选示例值: 1

图片顺序，从 1 开始连续递增

type string Optional 示例值: image

素材类型，仅支持 image，默认 image

name string 必选示例值: 银色咖啡机

参考图片名称；同名的不同引用会在输出时添加可读后缀，并同步 Prompt 中的 @名称，详见 Poll

uri string 必选示例值: tos://bucket/coffee-machine.png

可访问的图片 URI，支持 tos://、http://、https://，包括有效的预签名 URL

callback Callback Optional

可选任务状态回调。需先为当前账号、算子及版本开通回调功能；未启用时请省略 callback 并通过 Poll 查询，否则提交失败

url string 必选示例值: https://example.com/callback

公网可访问的 HTTPS 回调地址

推荐使用 storyboard_bundle_url。仅在没有 bundle 或需要提交编辑后的分镜时使用 storyboard_segments，两者不要同时传入。bundle manifest 顶层必须为 storyboard_bundle_v2、storage_mode=split，并引用可读取的 segments 和 shots JSON 文件；manifest 及其引用的每个 JSON 文件不超过 2 MiB。

算子会按顺序去重辅助引用并跳过未知引用。若参考图存在冲突 URI、无法唯一确定变体，或内联 URI 与素材登记不一致，该引用会被跳过而不是随机选择；保留的引用会重新连续编号。

返回数据

metadata metadata

请求元信息

task_id string 示例值: task-xxx

异步任务 ID，用于查询任务状态和结果

task_status string 示例值: PENDING

任务状态：PENDING、RUNNING、COMPLETED、FAILED、EXPIRED、CANCELLED、TIMEOUT。PENDING、RUNNING 为非终态；其余为终态，应停止轮询。EXPIRED 表示排队等待超时；CANCELLED 表示已取消

business_code string 示例值: 0

业务码

error_msg string

异常详情

请求示例

返回示例

错误码

HttpStatusCode	错误码	错误信息	描述
400	Parameter.Invalid	The parameter is invalid.	请求参数不合法，例如缺少方舟凭证、model_name 为空、同时传入多个模型选择字段、分镜结构或时间范围不符合约束，或尝试使用批量提交
401	Authorization.Missing	Missing Authorization.	缺少 LAS 鉴权
401	ApiKey.Invalid	The api key is invalid.	LAS API Key 不合法
500	Server.InternalError	General Internal Error.	服务内部错误

Poll

接口说明

查询视频提示词逆向生成任务的状态和逐分镜结果。

仅当所有分镜均成功时，任务返回 COMPLETED，并按输入顺序返回全部成功结果。任一分镜生成或处理失败时，任务整体返回 FAILED，不返回部分成功的 items。请修正输入或故障原因后重新提交完整任务。

生成的非空 Prompt 不会仅因超过 32000 字符、包含控制字符、格式不符合预期或模型未正常结束而被丢弃。文本可能不完整，使用前请检查并按下游要求编辑。分镜 Prompt 空输出、分镜生成模型调用失败、超时及必要的输入校验失败仍会失败；服务不会因此自动重试。

缺少实测分辨率或宽高比时省略相应规格，保留生成正文。

名称唯一性由 Submit 的 data.reference_name_scope 决定。省略或设为 task 时，在整任务内分配唯一名称，同一组原始 name、reference_id、uri 跨分镜复用名称；设为 segment 时，各分镜独立去重，跨分镜允许同名，单个分镜内原本唯一的名称保持不变。同名的不同图片会在所选范围内按输入顺序从 _1 开始编号，并避开已有名称。该参数只调整名称及 Prompt 中对应的 @引用，不改变保留引用的 ID、URI、位置、顺序、数量或 primary 选图。返回的预签名 URI 沿用原有效期，Poll 不续签。

例如，两段各有三张名为“杯”的不同图片时，task 会依次返回第一段的杯_1～杯_3 和第二段的杯_4～杯_6；segment 会在两段中分别返回杯_1～杯_3。

本版本 Poll 不提供 metadata.submit_time 和 metadata.end_time。HTTP 200 不代表任务执行成功；请同时检查 metadata.task_status、metadata.business_code 和 metadata.error_msg。

源视频事实理解失败或事实输出不可用时，服务可降级后继续生成分镜 Prompt；若所有分镜生成成功，任务仍为 COMPLETED。公开结果不提供内部 quality 或 warnings，因此 COMPLETED 不代表事实已核验或生成效果已验收；usage.complete 仅表示用量信息是否完整。

请求参数

名称	类型	是否必选	示例值	描述
operator_id	string	是	las_viral_reverse_prompt	算子 ID
operator_version	string	是	v1	算子版本
task_id	string	是	task-xxx	异步任务 ID

返回数据

metadata metadata

请求元信息

task_id string 示例值: task-xxx

异步任务 ID

task_status string 示例值: COMPLETED

任务状态：PENDING、RUNNING、COMPLETED、FAILED、EXPIRED、CANCELLED、TIMEOUT。PENDING、RUNNING 为非终态；其余为终态，应停止轮询。EXPIRED 表示排队等待超时；CANCELLED 表示已取消。当 task_status=COMPLETED 时，表示任务已完成且所有分镜均成功；结果见 data.items

business_code string 示例值: 0

业务码；通常结合 task_status=COMPLETED 和 business_code=0 判断成功

error_msg string

异常详情

data ViralReversePromptResult

任务成功时返回的逐分镜 Prompt 和用量汇总

items list of ReversePromptItem

按输入分镜顺序返回的 Prompt

segment_id string 示例值: segment-001

请求中的分镜 ID

source_segment_id string 示例值: source-segment-001

请求中的源分镜 ID；输入省略 source_segment_id 时为该分镜的 segment_id

prompt string 示例值: 【任务类型】复刻咖啡机产品展示片段……

为该分镜生成的非空视频 Prompt

references list of ReversePromptReference

实际保留的参考图片；有歧义的 Bundle 引用会跳过。字段与 Submit 一致，name 可能添加后缀

reference_id string 示例值: product-1

参考图片 ID

position integer 示例值: 1

图片顺序，从 1 开始连续编号

type string 示例值: image

固定为 image

name string 示例值: 金属杯_1

用于 Prompt 中 @引用的最终名称；请使用返回名称，不要假设与输入相同

uri string 示例值: tos://bucket/coffee-machine.png

参考图片 URI

usage ReversePromptUsage

本次任务的方舟模型调用用量汇总

request_count integer 示例值: 2

方舟模型请求总次数，包括源视频事实理解和各分镜 Prompt 扩写

total_tokens integer 示例值: 4096

所有方舟模型请求的总 Token 数；任一调用缺少用量时可能为空

complete boolean 示例值: true

表示模型调用用量信息是否完整；该字段不表示任务状态。失败任务的用量可能包含已执行的模型请求，实际费用以方舟账单为准

请求示例

返回示例

以下示例假设同一分镜保留了两张原名均为“金属杯”的不同图片。

错误码

HttpStatusCode	错误码	错误信息	描述
200	TaskId.Invalid	The task id is invalid.	任务不存在或当前账号不可访问；返回 metadata.task_status=FAILED，错误码位于 metadata.business_code
200	Video.VLMFailed	VLM call failed.	模型输出或模型服务调用失败；结合 error_msg 中的安全原因码处理。
401	Authorization.Missing	Missing Authorization.	缺少 LAS 鉴权
401	ApiKey.Invalid	The api key is invalid.	LAS API Key 不合法
500	Server.InternalError	General Internal Error.	服务内部错误

当 business_code 为 Video.VLMFailed 时，可结合 error_msg 中的以下原因码处理：

error_msg 原因码	含义与建议
PROVIDER_AUTHENTICATION_FAILED	模型资源认证失败；检查传入的方舟 API Key。
PROVIDER_PERMISSION_DENIED	模型资源无权限；检查传入的方舟 API Key 是否有权访问所选模型。
PROVIDER_RATE_LIMITED	模型服务限流；退避后重试。
PROVIDER_TIMEOUT	模型服务调用超时；退避后重试。
PROVIDER_UNAVAILABLE	模型服务暂时不可用；退避后重试。
PROVIDER_FAILURE	其他模型服务失败；联系服务方并提供 task_id。

AI 数据湖服务