视频 Prompt 生成算子将自然语言创作需求整理为可执行的视频生成 Prompt。可选传入最多 9 张参考图片,帮助模型理解人物、商品、场景或风格素材。
Operator ID: las_video_prompt_generate
细分项 | 详细要求 |
|---|---|
Submit RPM | 200 |
Poll RPM | 300 |
细分项 | 详细要求 |
|---|---|
支持的输入数据模态 |
|
输入格式:文本 |
|
输入格式:图片 |
|
输入路径要求 | 参考图片通过模型可访问的 URI 提供。
|
细分项 | 详细要求 |
|---|---|
支持的输出数据模态 | 文本。 |
输出格式:文本 | 返回根据创作需求和可选参考图片生成的视频 Prompt。
|
输出方式 | 任务完成后通过 Poll 接口的 |
使用您自己的方舟账号调用模型或指定接入点,具体费用以该方舟账号的实际模型用量为准。
本算子需调用您自己开通的方舟模型,账单也出具在您自己的方舟模型账单下,因此,在使用算子前您需先开通方舟模型,并获取方舟模型调用的认证信息(ark_api_key)和模型信息(模型 ID、接入点信息)。
细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
Authorization: Bearer <LAS_API_KEY> 用于 LAS 服务鉴权。data.ark_api_key 用于方舟调用;data.ark_endpoint_id 可选,省略时直接调用对应模型 ID。请勿记录、分享或提交真实密钥。说明
当前算子不支持批量提交。
提交视频提示词逆向生成异步任务。
Authorization: Bearer <LAS_API_KEY> 用于 LAS 服务鉴权,鉴权参数取值为 LAS API Key;请求体中的 ark_api_key须使用您自己的方舟 API Key 进行鉴权;所有接入点选填,省略时使用doubao-seed-2-1-pro-260628。Parameter | Type | Required | Example value | Description |
|---|---|---|---|---|
operator_id | string | 是 | las_video_prompt_generate | 算子 ID |
operator_version | string | 是 | v1 | 算子版本 |
data | PromptGenerateInfo | 是 | Prompt 生成参数 | |
callback | Callback | 否 | 可选任务状态回调。仅在控制面对当前账号、算子及版本启用回调策略后可用;未启用时请省略 callback 并通过 Poll 查询,否则提交失败 |
Parameter | Type | Example value | Description |
|---|---|---|---|
metadata | metadata | 请求元信息 |
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_video_prompt_generate", "operator_version": "v1", "data": { "parameters": { "requirements": "生成一个 10 秒的产品展示视频 Prompt:清晨的厨房里,一台银色咖啡机自动完成研磨和萃取,突出金属质感与蒸汽细节。" }, "ark_api_key": "<YOUR_ARK_API_KEY>" } }'
{ "operator_id": "las_video_prompt_generate", "operator_version": "v1", "data": { "template_id": "spoken-shot-generate", "parameters": { "source_type": "direct", "project_text": "咖啡机产品口播广告", "shot_title": "萃取咖啡", "visual_description": "咖啡机将咖啡注入杯中", "dialogue": "享受一杯现磨咖啡", "duration_seconds": 6 }, "ark_api_key": "<YOUR_ARK_API_KEY>" } }
{ "metadata": { "task_id": "task-20260914120000-abc123", "task_status": "PENDING", "business_code": "0", "error_msg": "" } }
HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | Parameter.Invalid | The parameter is invalid. | 请求参数不合法,例如缺少方舟凭证、模型或参考图片参数不符合约束,或尝试使用批量提交 |
401 | Authorization.Missing | Missing Authorization. | 缺少 LAS 鉴权 |
401 | ApiKey.Invalid | The api key is invalid. | LAS API Key 不合法 |
500 | Server.InternalError | General Internal Error. | 服务内部错误 |
查询视频 Prompt 生成任务的状态和结果。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_video_prompt_generate | 算子 ID |
operator_version | string | 是 | v1 | 算子版本 |
task_id | string | 是 | task-xxx | 异步任务 ID |
Parameter | Type | Example value | Description |
|---|---|---|---|
metadata | metadata | 请求元信息 | |
data | PromptGenerateResult | 任务成功时返回的 Prompt 和用量 |
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_video_prompt_generate", "operator_version": "v1", "task_id": "task-20260914120000-abc123" }'
{ "metadata": { "task_id": "task-20260914120000-abc123", "task_status": "COMPLETED", "submit_time": "2026-09-14T12:00:00+08:00", "end_time": "2026-09-14T12:00:06+08:00", "business_code": "0", "error_msg": "" }, "data": { "prompt": "10 秒产品广告视频。清晨暖光厨房,中景展示银色咖啡机,镜头缓慢推进……", "usage": { "request_count": 1, "prompt_tokens": 1024, "completion_tokens": 256, "total_tokens": 1280 } } }
HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | TaskId.Invalid | The task id is invalid. | 任务 ID 不合法或任务不存在 |
401 | Authorization.Missing | Missing Authorization. | 缺少 LAS 鉴权 |
401 | ApiKey.Invalid | The api key is invalid. | LAS API Key 不合法 |
500 | Server.InternalError | General Internal Error. | 服务内部错误 |