创建视频生成任务
更新时间：2026-01-07
POST
https://qianfan.baidubce.com/video/generations
创建视频生成任务接口，支持文生视频、图生视频和首尾帧生视频
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型名称，用于指定使用的视频生成模型。
例如：wan-2.1-t2v-14b
必选
prompt
string
提示词，描述期望生成的视频内容。
例如：宇航员站起来走了
必选
negative_prompt
string
负向提示词，描述不希望在视频中出现的内容。
可选
prompt_image
string
提示图片，用于图生视频场景，提供图片参考。
可选
first_frame_image
string
首帧图片，用于首尾帧生视频场景，指定视频的第一帧画面。
可选
last_frame_image
string
尾帧图片，用于首尾帧生视频场景，指定视频的最后一帧画面。
可选
prompt_extend
boolean
是否启用提示词扩展功能，自动丰富和优化输入的提示词。
- true: 启用提示词扩展
- false: 不启用提示词扩展
可选
seed
integer
随机种子，用于控制生成结果的随机性，相同的种子在相同参数下会生成相似的结果。
可选
duration
integer
视频时长，指定生成视频的持续时间（单位：秒）。
可选
ratio
string
视频宽高比，指定生成视频的画面比例。
可选
model_parameters
object {3}
模型参数，用于配置视频生成的高级参数。
可选
显示子属性
隐藏子属性
num_inference_steps
integer
推理步数，控制模型生成的迭代次数，步数越多生成质量可能越好但耗时更长。
可选
sampler
string
采样器类型，指定生成过程使用的采样算法。
- unipc: UniPC采样器
- dpm++: DPM++采样器
可选
fps
integer
帧率，指定生成视频的每秒帧数。
可选
请求结构
POST /video/generations HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "wan-2.1-t2v-14b",
"prompt": "宇航员站起来走了"
}示例代码
创建一个文生视频任务的基本示例
curl -X POST "https://qianfan.baidubce.com/video/generations" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2.1-t2v-14b",
"prompt": "宇航员站起来走了"
}'{
"model": "wan-2.1-t2v-14b",
"prompt": "宇航员站起来走了"
}返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
请求的唯一标识，本次请求的唯一标识，可用于排查问题。
例如：as-xxxxxxxx
可选
task_id
string
任务标识，视频生成异步任务的任务id，生成结果需要通过使用此id在异步任务查询接口中获取。
例如：xxxxxxxxxxxxxxxx
可选
视频生成任务创建成功时的响应示例
成功响应
{
"id": "as-xxxxxxxx",
"task_id": "xxxxxxxxxxxxxxxx"
}接口URL
接口统一使用 https://qianfan.baidubce.com 作为 URL host，后接具体接口路径 /video/generations。
注意事项
- 该接口为异步任务接口，调用成功后会返回任务ID（
task_id），需要通过任务查询接口获取最终的视频生成结果 - 支持三种视频生成模式：文生视频（仅提供
prompt）、图生视频（提供prompt_image）、首尾帧生视频（提供first_frame_image和last_frame_image） - 请根据实际需求选择合适的参数组合