创建视频生成任务-文生视频
更新时间：2026-03-25
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
创建文生视频任务，通过输入纯文本提示词生成视频，返回task_id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
type
string
任务类型，固定值：text2video
必选
model
string
模型名称。可选值:
VQ3-Pro：支持音画同步及分镜生成，画质效果最佳。VQ3-Turbo：支持音画同步及分镜生成，生成速度更快。VQ2：最新模型，生成速度快，综合效果优秀。
必选
model_parameters
object {7}
模型参数配置。
必选
显示子属性
隐藏子属性
prompt
string
文本提示词，生成视频的文本描述，字符长度不能超过 1500 个字符
必选
duration
integer
视频时长（单位：秒）。
- VQ3 系列：默认值 5s，可选范围：1 - 16 的任意整数
- VQ2：默认值 5s，可选范围：1 - 10 的任意整数；
可选
seed
integer
随机种子。
当未传入种子或传入值为0时，系统将自动生成随机数作为种子，确保每次生成结果具有随机性。
用户可传入非零整数值作为固定种子，以实现结果的可复现性。
可选
aspect_ratio
string
视频比例，默认值 16:9。
可选值: 16:9、9:16、1:1。
注：3:4 和 4:3 仅支持 VQ2和VQ3系列模型。
可选
resolution
string
分辨率参数，默认值依据模型和视频时长而定：
VQ3-Pro、VQ3-Turbo：默认 720p，可选：540p、720p、1080pVQ2（1-8秒）：默认为 720p，可选：540p、720p、1080p
可选
bgm
boolean
是否为生成的视频添加背景音乐，默认值：false。
true：开启。系统将从预设 BGM 库中自动挑选并适配适合视频时长的音乐。false：关闭。不添加背景音乐。 生效限制：- 该参数在
VQ3模型中不生效。 - 在
VQ2系列模型且视频时长 (duration) 设置为 9秒 或 10秒 时，bgm参数不生效。
可选
audio
boolean
是否使用音视频直出能力，默认为 true
false：静音视频true：音画同步视频
注：仅VQ3系列模型支持该参数。
可选
请求结构
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"type": "text2video",
"model": "VQ3-Pro",
"model_parameters": {
"prompt": "一座位于云端的未来主义城市，赛博朋克风格，高质量，高细节。",
"duration": 5,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "1080p",
"bgm": false,
"audio": true
}
}示例代码
请求示例
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 '{
"type": "text2video",
"model": "VQ3-Pro",
"model_parameters": {
"prompt": "一座位于云端的未来主义城市，赛博朋克风格，高质量，高细节。",
"duration": 5,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "1080p",
"bgm": false,
"audio": true
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
log_id
string
请求的唯一标识 log_id
必选
task_id
string
任务ID，用于后续查询生成结果。
必选
status
string
任务状态，标识当前任务所处阶段。
created创建成功queueing任务排队中processing任务处理中success任务成功failed任务失败
必选
model
string
使用的模型名称。
必选
prompt
string
输入的提示词内容。
必选
duration
integer
视频时长 (秒)。
可选
seed
integer
使用的随机种子。
可选
resolution
string
生成的视频分辨率。
可选
aspect_ratio
string
视频比例。
可选
created_at
string
任务创建时间，格式为 ISO 8601
必选
响应示例
{
"log_id": "as-pfsjh52npm",
"task_id": "69ba527fcb4dd0d29f59d415",
"status": "created",
"model": "VQ3-Pro",
"prompt": "一座位于云端的未来主义城市，赛博朋克风格，高质量，高细节。",
"duration": 5,
"seed": 0,
"resolution": "1080p",
"aspect_ratio": "16:9",
"created_at": "1773818495000"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_genration_interal_error | video generation service interal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_genration_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_genration_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章