创建视频生成任务-首尾帧生视频
更新时间：2026-01-30
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
创建视频生成任务-首尾帧生视频。根据首帧图和尾帧图生成过渡自然的视频，返回任务ID用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型ID，枚举值:VQ1,VQ1-Classic,V2.0,VQ2-Turbo,VQ2-Pro
必选
type
string
任务类型，枚举值:start-end2video
必选
model_parameters
object {7}
必选
显示子属性
隐藏子属性
images
array
图片URL列表，用于首尾帧生成
必选
显示子属性
隐藏子属性
items
string
图片URL地址
prompt
string
提示词，用于指导视频生成
必选
duration
integer
视频生成时长（秒）
可选
is_rec
boolean
是否...
可选
resolution
string
视频分辨率
可选
movement_amplitude
string
运动幅度，枚举值:auto,small,medium,large
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-Pro",
"type": "start-end2video",
"model_parameters": {
"images": [
"https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg",
"https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg"
],
"prompt": "云朵快速流动，延时摄影效果",
"duration": 5,
"resolution": "720p",
"movement_amplitude": "large",
"seed": 999
}
}示例代码
请求示例
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": "start-end2video",
"model_parameters": {
"images": [
"https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg",
"https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg"
],
"prompt": "云朵快速流动，延时摄影效果",
"duration": 5,
"resolution": "720p",
"movement_amplitude": "large",
"seed": 999
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
log_id
string
日志ID，用于问题排查
可选
task_id
string
任务ID，用于查询任务状态和结果
可选
status
string
任务状态
可选
model
string
使用的模型ID
可选
images
array
输入的图片URL列表
可选
显示子属性
隐藏子属性
items
string
图片URL地址
prompt
string
输入的提示词
可选
duration
integer
视频时长（秒）
可选
resolution
string
视频分辨率
可选
movement_amplitude
string
运动幅度
可选
seed
integer
随机种子
可选
created_at
string
任务创建时间，格式为Unix时间戳（毫秒），时区为UTC+8
可选
任务创建成功
{
"log_id": "as-mqgjiteu5p",
"task_id": "697b263828a819d37fce4d41",
"status": "created",
"model": "VQ2-Pro",
"images": [
"https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg",
"https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg"
],
"prompt": "云朵快速流动，延时摄影效果",
"duration": 5,
"seed": 999,
"resolution": "720p",
"movement_amplitude": "large",
"created_at": "1769678392000"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| 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 |