创建视频生成任务-文生视频
更新时间：2026-01-29
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
根据输入的文本提示词生成视频，返回任务创建结果
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型ID，用于指定使用的视频生成模型。
枚举值:VQ1,VQ2
必选
type
string
任务类型，用于指定生成的视频模式。
枚举值:text2video
必选
model_parameters
object {7}
必选
显示子属性
隐藏子属性
prompt
string
提示词，用于描述想要生成的视频内容。
必选
style
string
视频风格，用于指定生成视频的艺术风格。
枚举值:general,anime
可选
duration
integer
视频时长，用于指定生成视频的持续时间（秒）。
可选
resolution
string
分辨率，用于指定生成视频的清晰度。
枚举值:540p,720p,1080p
可选
aspect_ratio
string
宽高比，用于指定生成视频的画面比例。
枚举值:16:9,9:16,3:4,4:3,1:1
可选
movement_amplitude
string
运动幅度，用于指定生成视频的画面动态强度。
枚举值:auto,small,medium,large
可选
seed
integer
随机种子，用于控制生成结果的随机性。
可选
请求结构
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "VQ2",
"type": "text2video",
"model_parameters": {
"prompt": "一位赛博朋克风格的侦探行走在雨夜霓虹闪烁的城市中，电影级光影效果，高度细节化，4K画质。",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"seed": 42
}
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/beta/video/generations/qianfan-video" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "VQ2",
"type": "text2video",
"model_parameters": {
"prompt": "一位赛博朋克风格的侦探行走在雨夜霓虹闪烁的城市中，电影级光影效果，高度细节化，4K画质。",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"seed": 42
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
log_id
string
日志ID，用于问题排查。
可选
task_id
string
任务ID，用于查询任务状态和结果。
可选
status
string
任务状态，标识当前任务所处阶段。
可选
model
string
使用的模型ID。
可选
style
string
设置的视频风格。
可选
prompt
string
输入的提示词内容。
可选
duration
integer
生成的视频时长。
可选
seed
integer
使用的随机种子。
可选
resolution
string
生成的视频分辨率。
可选
movement_amplitude
string
设置的运动幅度。
可选
aspect_ratio
string
生成的视频宽高比。
可选
created_at
string
任务创建的时间，格式为时间戳字符串（毫秒级）。
可选
任务创建成功
{
"log_id": "as-ztsftc4723",
"task_id": "697b1eec9e7e53a32e55b50d",
"status": "created",
"model": "VQ2",
"prompt": "一位赛博朋克风格的侦探行走在雨夜霓虹闪烁的城市中，电影级光影效果，高度细节化，4K画质。",
"duration": 5,
"seed": 42,
"resolution": "720p",
"aspect_ratio": "16:9",
"created_at": "1769676524000"
}