创建视频生成任务-图生视频
更新时间：2026-03-25
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
根据输入的一张首帧图像和文本提示词生成视频，返回task_id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
用于生成视频的模型。
可选值如下：
VQ3-Pro：支持音画同步及分镜生成，画质效果最佳。VQ3-Turbo：支持音画同步及分镜生成，生成速度更快。VQ2-Turbo：最新模型，生成速度快，综合效果优秀。VQ2-Pro：最新模型，画面细节丰富，生成质量高。
必选
type
string
任务类型，固定值：img2video。
必选
model_parameters
object {9}
模型参数配置。
必选
显示子属性
隐藏子属性
images
array
首帧图像。
支持图片 URL（需公网可访问）或 Base64 编码。
- 数量限制：仅支持输入 1 张图片。
- 支持格式：png、jpeg、jpg、webp。
- 比例限制：图片宽高比需介于 1:4 至 4:1 之间。
图片文件不可超过 50 MB；Base64 解码后的字节长度需小于 10 MB。使用 Base64 时必须包含完整的内容类型前缀，例如：data:image/png;base64,{base64_encode}。
必选
显示子属性
隐藏子属性
items
string
prompt
string
文本提示词，生成视频的文本描述。
字符长度不能超过 2000 个字符；
若使用 is_rec 推荐提示词参数，模型将忽略此参数所输入的提示词。
可选
audio
boolean
是否使用音视频直出能力，默认为 false
false：静音视频true：音画同步视频
该参数为true时，voice_id参数生效；
当model为VQ3系列时，该参数默认值为true。
可选
bgm
boolean
是否为生成的视频添加背景音乐，默认值：false。
true：开启。系统将从预设 BGM 库中自动挑选并适配适合视频时长的音乐。false：关闭。不添加背景音乐。 生效限制：- 当
audio参数为true时，bgm参数不生效。 - 当使用
VQ3系列模型，以及VQ2系列模型且视频时长 (duration) 设置为 9秒 或 10秒 时，bgm参数不生效。
可选
duration
integer
视频时长（秒）。
VQ3-Pro、VQ3-Turbo：默认为 5，可选范围：1 - 16 的任意整数VQ2-Pro：默认为 5，可选范围：1 - 10 的任意整数VQ2-Turbo：默认为 5，可选：1 - 10 的任意整数
可选
is_rec
boolean
是否使用系统推荐提示词。默认值：false。
true：由系统自动生成 1 条提示词并作为视频生成依据。false：根据用户传入的prompt参数生成视频。- 计费说明：开启该功能后，每个任务将额外消耗 10 积分。
可选
resolution
string
分辨率参数，默认值依据模型和视频时长而定：
VQ3-Pro、VQ3-Turbo：默认 720p，可选：540p、720p、1080pVQ2-Pro：默认为 720p，可选：540p、720p、1080pVQ2-Turbo：默认为 720p，可选：540p、720p、1080p
可选
seed
integer
随机种子。
当未传入种子或传入值为0时，系统将自动生成随机数作为种子，确保每次生成结果具有随机性。
用户可传入非零整数值作为固定种子，以实现结果的可复现性。
可选
请求结构
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "VQ2-Pro",
"type": "img2video",
"model_parameters": {
"images": [
"https://example.com/test_image_1.jpg"
],
"prompt": "一条缓缓流淌的河流，电影级光影效果"
}
}示例代码
curl
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-Pro",
"type": "img2video",
"model_parameters": {
"images": [
"https://example.com/test_image_1.jpg"
],
"prompt": "一条缓缓流淌的河流，电影级光影效果",
"duration": 5,
"resolution": "720p",
"movement_amplitude": "medium",
"seed": 12345,
"is_rec": true
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
log_id
string
日志ID，用于问题排查。
必选
task_id
string
任务ID，用于后续查询生成结果。
必选
status
string
任务状态，标识当前任务所处阶段。
created创建成功queueing任务排队中processing任务处理中success任务成功failed任务失败
必选
model
string
使用的模型名称。
必选
images
array
首帧图像。
必选
显示子属性
隐藏子属性
items
string
prompt
string
输入的提示词内容。
必选
duration
integer
视频时长 (秒)。
可选
seed
integer
使用的随机种子。
可选
resolution
string
生成的视频分辨率。
可选
movement_amplitude
string
设置的运动幅度。
可选
created_at
string
任务创建的时间，格式为时间戳字符串（毫秒级）。
必选
成功响应
{
"log_id": "as-tbatpi9zxz",
"task_id": "697b217128a819d37fce4c4b",
"status": "created",
"model": "VQ2-Pro",
"images": [
"https://example.com/test_image_1.jpg"
],
"prompt": "一条缓缓流淌的河流，电影级光影效果",
"duration": 5,
"seed": 12345,
"resolution": "720p",
"movement_amplitude": "medium",
"created_at": "1769677169000"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| 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 |
评价此篇文章