视频 Prompt 生成算子将自然语言创作需求整理为可执行的视频生成 Prompt。可选传入最多 9 张参考图片，帮助模型理解人物、商品、场景或风格素材。调用时需要设置方舟 API Key，并可选择模型档位或指定精确模型。私有桶中的参考图片请使用 tos:// URI。

算子介绍

核心功能

将创作目标、内容要求和语言要求整理为单份视频生成 Prompt。

可使用 video-prompt-revise 模板显式区分原 Prompt 与修改要求，并返回最终引用和被移除的已知素材引用。

支持结合参考图片描述人物、商品、场景和视觉风格。

返回请求次数和 Token 用量，便于调用方追踪消耗。

模型选择

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

推荐使用 model_tier，这样服务端可以在不修改请求的情况下维护具体模型。需要固定模型版本时再使用非空 model_name，服务会将其原样传给方舟。两者不能同时传入。示例列表不是准入白名单；提交前请确认模型在当前地域可用且方舟 API Key 有权访问。模型不存在、地域不可用或 API Key 无权访问时由方舟返回失败；服务不降级、不自动重试。

requirements 填写建议

从零生成：说明目标时长、主体、场景、动作、镜头、光线、风格和声音要求。

优化现有 Prompt：依次写明“现有 Prompt”“本次修改要求”“保持不变”，并要求返回完整 Prompt。

全局调整：明确调整范围和目标值，例如“总时长改为 20 秒”“所有镜头统一为暖色自然光”；同时列出不得改变的主体事实和动作顺序。

算子会根据整段 requirements 重新生成完整 Prompt；如需严格保留某项内容，请在要求中显式写出。

从 0 生成 Prompt 示例

优化现有 Prompt 示例

全局调整现有 Prompt 示例

支持的地域

北京：cn-beijing

上海：cn-shanghai

广州：cn-guangzhou

算子性能

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

输入与输出要求

输入要求

细分项	详细要求
支持的输入数据模态	文本图片
输入格式：文本	通用需求模板的 requirements 最长 32000 字符；显式改写模板的 original_prompt 与 revision_requirements 各最长 32000 字符；locale 支持 zh-CN、en-US；口播模板项目背景最长 5000 字符、五个文本字段合计最长 32000 字符、时长 4～30 秒。
输入格式：图片	* 数量：最多 9 张；数组顺序即图片顺序，position 可省略；可通过 asset_id 保留调用方素材标识。
输入路径要求	文本需求通过 data.parameters 提供；参考图片通过 data.references[].uri 提供。 uri 必须是模型可访问的稳定地址，支持 tos:// 或可直接访问的 HTTP/HTTPS URL；私有桶图片请使用 tos:// URI，由服务端生成临时访问地址。公网 URL 不支持依赖登录态、Cookie 或额外 Header 鉴权。不支持带签名参数的临时预签名 URL。 TOS 对象需与当前 LAS 服务同主账号、同地域，并具备读取权限。

输出要求

细分项	详细要求
支持的输出数据模态	文本。
输出格式：文本	返回根据创作需求和可选参考图片生成的视频 Prompt。语言：通用需求模板通过 locale 选择 zh-CN 或 en-US；口播模板输出中文。
输出方式	任务完成后通过 Poll 返回 data.prompt、最终使用的 data.references，以及显式改写中被移除的 data.missing_references。

计费说明

调用时需要设置有效的方舟 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 调用

凭证说明

请求头 Authorization: Bearer <LAS_API_KEY> 用于 LAS 服务鉴权。

请求体 data.ark_api_key 用于方舟调用。请勿记录、分享或提交真实密钥。

Submit

接口说明

提交视频 Prompt 生成异步任务。

请求头使用 Authorization: Bearer <LAS_API_KEY> 用于 LAS 服务鉴权；请求体中的 ark_api_key 必须是有效的方舟 API Key。默认使用 Pro 档位，也可通过 model_tier 选择档位，或通过 model_name 指定精确模型。

成功后返回任务 ID，可通过 Poll 查询结果。

如需明确区分原 Prompt 与修改要求，并获得被删除或替换的素材引用，请使用 template_id=video-prompt-revise，分别填写 original_prompt 和 revision_requirements。仅把旧 Prompt 粘贴到 requirements 中不会计算旧素材差异。

显式改写时，references 应同时包含旧素材与新候选素材的映射。最终返回哪些素材以 Poll 中的实际引用为准，未使用的候选不属于被删除素材。

请求参数

operator_id string 必选示例值: las_video_prompt_generate

算子 ID

operator_version string 必选示例值: v1

算子版本

data PromptGenerateInfo 必选

Prompt 生成参数

template_id string Optional 示例值: video-prompt-from-requirements

Prompt 模板。默认 video-prompt-from-requirements（通用视频需求）；还支持 spoken-shot-generate（口播单分镜）和 video-prompt-revise（显式改写）。

parameters PromptGenerateParameters 必选

参数随 template_id 选择；下表汇总三种模板的字段，只传所选模板的字段，不可混用。口播模板的五个文本字段合计最长 32000 字符

locale string Optional 示例值: zh-CN

通用需求和显式改写模板可传：zh-CN 或 en-US，默认 zh-CN；口播模板不接受此字段，输出中文

requirements string Conditional 示例值: 生成一个 10 秒的咖啡机产品展示视频 Prompt

仅通用需求模板必填；支持描述从零生成需求，也支持同时提供现有 Prompt 和修改要求并要求返回完整的新 Prompt；去除首尾空白后不能为空，最长 32000 字符

source_type string Optional 示例值: direct

仅口播模板可传，默认 direct：direct 或 copywriting；后者强化当前单分镜边界

project_text string Conditional 示例值: 咖啡机产品口播广告

仅口播模板必填；项目背景，去除首尾空白后不能为空，最长 5000 字符

shot_title string Conditional 示例值: 萃取咖啡

仅口播模板必填；当前分镜标题，去除首尾空白后不能为空

visual_description string Conditional 示例值: 咖啡机将咖啡注入杯中

仅口播模板必填；当前分镜画面与动作，去除首尾空白后不能为空

dialogue string Optional 示例值: 享受一杯现磨咖啡

仅口播模板可传；当前分镜台词，默认空字符串，不补写台词

duration_seconds integer Conditional 示例值: 6

仅口播模板必填；当前分镜可承载时长，4～30 秒

director_style string Optional 示例值: 自然居家光线

仅口播模板可传；导演风格。与 project_text、shot_title、visual_description、dialogue 合计最长 32000 字符

original_prompt string Conditional 示例值: @旧杯放在桌上

仅显式改写模板必填；原 Prompt，去除首尾空白后不能为空，最长 32000 字符。

revision_requirements string Conditional 示例值: 将 @旧杯替换为 @新杯

仅显式改写模板必填；修改要求，去除首尾空白后不能为空，最长 32000 字符。

generation_parameters VideoGenerationParameters Optional

仅显式改写模板可传；明确目标规格，优先于原文和修改要求中的冲突规格。

ratio string Optional 示例值: 16:9

目标画面比例，最长 64 字符。

resolution string Optional 示例值: 720p

目标分辨率，最长 64 字符。

ark_api_key string 必选示例值: <YOUR_ARK_API_KEY>

有效的方舟 API Key。

model_tier string Optional 示例值: pro

推荐的模型选择方式，可选 lite、standard、pro，默认 pro。各档位会映射到当前地域支持的模型

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

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

references list of PromptGenerateReference Optional

参考图片，最多 9 项；数组顺序即图片顺序，position 可省略，reference_id 和 name 不能重复。显式改写时需同时提供原 Prompt 已引用素材和新候选素材，才能识别被移除的已知引用。

reference_id string 必选示例值: product-1

当前请求内唯一的参考图片 ID

position integer Optional 示例值: 1

省略时使用数组中的顺序；提供时须与数组位置一致且连续。

type string Optional 示例值: image

固定为 image，默认 image。

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

参考图片名称，当前请求内不能重复

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

模型可访问的稳定图片 URI，支持 tos://、http://、https://。私有桶图片请传 tos:// URI，由服务端生成临时访问地址；不接受带签名参数的预签名 HTTPS URL

asset_id string Optional 示例值: customer-cup

调用方素材 ID；返回引用中原样保留，服务不会据此导入素材。

callback Callback Optional

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

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

公网可访问的 HTTPS 回调地址

返回数据

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 为空、同时传入 model_tier 与 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

接口说明

查询视频 Prompt 生成任务的状态和结果。

成功结果始终包含 references 和 missing_references 数组，无内容时为 []。references 只包含最终 Prompt 中精确命中已知 @名称的输入素材，每个 ID 仅返回一次，并保持输入数组的相对顺序；未知名称保留为文本，不生成素材身份或 URI。

missing_references 仅在 video-prompt-revise 中表示原 Prompt 已引用、最终 Prompt 不再引用的已知素材。通用需求和口播模板始终返回空数组。结果素材对象不返回 position，顺序由数组表达。本版本 Poll 不返回 metadata.submit_time 和 metadata.end_time。

任务执行失败时，请结合 metadata.business_code 和 metadata.error_msg 排查：

Parameter.Invalid：参考图使用了带签名参数的预签名 URL；error_msg 中的 references[n].uri 使用从 0 开始的数组下标。请改用稳定 URI，例如私有桶的 tos:// 地址。

ReferenceImage.DownloadFailed：模型服务明确报告参考图下载失败，error_msg 可能包含 MEDIA_DOWNLOAD_FAILED 或 MEDIA_DNS_RESOLUTION_FAILED。该错误不保证指出具体图片，请检查参考图地址与访问权限。

Video.VLMFailed：其他模型调用失败。

请求参数

名称	类型	是否必选	示例值	描述
operator_id	string	是	las_video_prompt_generate	算子 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 表示已取消

business_code string 示例值: 0

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

error_msg string

异常详情

data PromptGenerateResult

任务成功时返回的 Prompt 和用量

prompt string 示例值: 10 秒产品视频，@新杯放在厨房桌上……

生成的完整视频 Prompt

references list of PromptGenerateResultReference

最终 Prompt 实际引用的输入素材；无引用时返回空数组。只识别精确匹配的已知 @名称，未知名称保留为文本。

missing_references list of PromptGenerateResultReference

仅显式改写模板用于返回原 Prompt 已引用、最终 Prompt 不再引用的已知素材；其他模板或无差异时返回空数组。

PromptGenerateResultReference object

引用对象。

reference_id string

输入参考图片 ID。

type string

固定为 image。

name string

输入素材名称，对应 Prompt 中的 @引用。

uri string

输入图片 URI。

asset_id string

输入提供时原样返回。

usage PromptGenerateUsage

本次方舟模型调用用量

request_count integer 示例值: 1

方舟模型请求次数

prompt_tokens integer 示例值: 1024

输入 Token 数量；提供方未返回时可能为空

completion_tokens integer 示例值: 256

输出 Token 数量；提供方未返回时可能为空

total_tokens integer 示例值: 1280

总 Token 数量；提供方未返回时可能为空

请求示例

返回示例

错误码

HttpStatusCode	错误码	错误信息	描述
200	TaskId.Invalid	The task id is invalid.	任务不存在或当前账号不可访问；返回 metadata.task_status=FAILED，错误码位于 metadata.business_code
200	Parameter.Invalid	The parameter is invalid.	参考图地址不符合要求，例如使用带签名参数的预签名 URL；请结合 error_msg 定位对应的 references[n].uri。
200	ReferenceImage.DownloadFailed	Reference image download failed.	模型服务报告参考图下载失败；检查 URI、访问权限和域名解析。
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 数据湖服务