创建视频生成任务-图生视频
更新时间：2026-01-30
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
创建视频生成任务，根据输入的一张首帧图像和文本提示词生成视频，返回task_id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型ID，用于指定生成视频使用的模型。
可选值：V2.0、VQ1、VQ2-Turbo、VQ2-Pro
- VQ2-Pro：新模型，效果好，细节丰富
- VQ2-Turbo：新模型，效果好，生成快
- VQ1：画面清晰，平滑转场，运镜稳定
- V2.0：生成速度快
必选
type
string
任务类型，固定值：img2video。
必选
model_parameters
object {7}
必选
显示子属性
隐藏子属性
images
array
首帧图像，用于指定视频生成的起始画面。仅允许传入 1 张图片作为首帧。
该参数支持图片 URL（需公网可访问）或 Base64 编码字符串。
- 格式支持：兼容主流的图像格式，包括
png、jpeg、jpg及webp。 - 尺寸比例：图片的宽高比需控制在 1:4 至 4:1 的区间内，超出此范围可能导致画面裁剪或处理异常。
- 文件大小：原始图片文件不得超过 50 MB。
- Base64 编码要求：解码后的字节流长度必须限制在 10 MB 以内。格式示例：
data:image/png;base64,{base64_encode}
必选
显示子属性
隐藏子属性
items
string
prompt
string
提示词，用于描述生成的视频内容。
字符长度不能超过 1500 个字符。
必选
duration
integer
视频时长（秒）。
VQ2-Pro：默认设置为 5 秒，支持自定义设置 1 至 10 秒 的任意整数时长。VQ2-Turbo：默认设置为 5 秒，支持自定义设置 1 至 10 秒 的任意整数时长。VQ1：默认设置为 5 秒，仅支持 5 秒 固定时长。V2.0：默认设置为 4 秒，仅支持选择 4 秒 或 8 秒 两个特定时长档位。
可选
is_rec
boolean
是否使用推荐提示词。
true：启用优化。系统将自动生成 1 组推荐提示词，直接用于视频生成。false：禁用优化。系统将严格按照用户输入的 Prompt 内容进行视频生成。 计费提示：启用该功能后，每个生成任务将额外消耗 10 积分。
可选
resolution
string
分辨率，用于指定生成视频的清晰度。
VQ2-Pro：默认分辨率为 720p。支持选择 540p、720p 或 1080p。VQ2-Turbo：默认分辨率为 720p。支持选择 540p、720p 或 1080p。VQ1 (5秒模式)：默认且仅支持 1080p。V2.0 (4秒模式)：默认分辨率为 360p。支持选择 360p、720p 或 1080p。V2.0 (8秒模式)：默认且仅支持 720p。
可选
movement_amplitude
string
运动幅度，用于控制画面中元素的运动强度。
默认值：auto (自动适配)
可选值：
autosmallmediumlarge
可选
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://qianfan-doc.bj.bcebos.com/image_test/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://qianfan-doc.bj.bcebos.com/image_test/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://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg"
],
"prompt": "一条缓缓流淌的河流，电影级光影效果",
"duration": 5,
"seed": 12345,
"resolution": "720p",
"movement_amplitude": "medium",
"created_at": "1769677169000"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 400 | BadRequest | bad request | 不合法的请求。 |
| 400 | FieldLacking | field is missing or empty: {{.fields}} | 缺少字段，具体字段见错误信息。 |
| 400 | FieldUnwanted | unwanted field: {{.fields}} | 不需要传某些字段，具体字段见错误信息。 |
| 400 | FieldItemCountOutOfRange | field item count out of range: {{.fields}} | 字段数量超出限制（如数组长度超限）。 |
| 400 | PageSizeOutOfRange | page size out of range | 图像尺寸或格式有问题。 1. 图片大小需小于 50M。 2. 格式只支持 jpg/jpeg/png/webp。 3. 图片长宽比需要小于 1:4 或者 4:1。 4. 跳舞特效的图片长宽比需要在 1:1.2 至 1:2 之间。 |
| 400 | ImageDownloadFailure | image download failure | 下载用户图片URL失败，请检查链接的有效性。 |
| 400 | OperationInProcess | operation in process, please retry later | 请求在处理中，请勿重复提交。 |
| 400 | TaskPromptPolicyViolation | prompt policy violation | Prompt 触发安审风控。 |
| 400 | ImageFormatInvalid | invalid image format | 图像格式不符合要求。 |
| 400 | AuditSubmitIllegal | submit is illegal | 输入内容（图片或文本）没有通过安全审核。 |
| 400 | CreationPolicyViolation | creation policy violation | 生成物触发风控。 |
| 400 | ModelUnavailable | model unavailable | 请求的模型不可用，调用任务失败，请检查模型类型并重试。 |
| 400 | FieldInvalid | invalid field: {{.fields}} | 传入参数未通过合法性校验。 |
| 400 | ImageCheckBodyJointsFailed | Image Check Body Joins Failed | 输入图人体检测失败，请重新上传。 |
| 400 | ImageCheckFaceFailed | Image Check Face Failed | 输入图人脸检测失败，请重新上传。 |
| 400 | ImageObjectsUndetected | Image BodyJoins or Face Too Much Occlusion | 输入图的人体或人脸有遮挡，请重新上传。 |
| 404 | TaskNotFound | task not found | Task id 没找到。 |
| 404 | CreationNotFound | creation not found | Creation id 没找到。 |
| 500 | InternalServiceFailure | internal service failure | 服务器内部错误，请稍后重试，或联系客服。 |
视频模型通用错误码
| 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 |