创建视频生成任务-首尾帧生视频
更新时间：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
任务类型，固定值：start-end2video。
必选
model_parameters
object {8}
模型参数配置。
必选
显示子属性
隐藏子属性
images
array
首尾帧图像列表必须包含 2 张图片：第一张为首帧，第二张为尾帧。
该参数支持图片 URL（需公网可访问）或 Base64 编码字符串。
- 格式支持：兼容主流的图像格式，包括
png、jpeg、jpg及webp。 - 尺寸比例：首帧图的分辨率/尾帧图的分辨率要在0.8～1.25之间，宽高比需控制在 1:4 至 4:1 的区间内，超出此范围可能导致画面裁剪或处理异常。
- 文件大小：原始图片文件不得超过 50 MB。
- Base64 编码要求：解码后的字节流长度必须限制在 10 MB 以内。格式示例：
data:image/png;base64,{base64_encode}
必选
显示子属性
隐藏子属性
items
string
prompt
string
提示词，用于描述生成的视频内容。
字符长度不能超过 1500 个字符。
必选
duration
integer
视频时长（秒）。
VQ3-Pro、VQ3-Turbo：默认设置为 5 秒，支持自定义设置 1 至 16 秒 的任意整数时长。VQ2-Pro：默认设置为 5 秒，支持自定义设置 1 至 8 秒 的任意整数时长。VQ2-Turbo：默认设置为 5 秒，支持自定义设置 1 至 8 秒 的任意整数时长。
可选
is_rec
boolean
是否使用推荐提示词。
true：启用优化。系统将自动生成 1 组推荐提示词，直接用于视频生成。false：禁用优化。系统将严格按照用户输入的 Prompt 内容进行视频生成。 计费提示：启用该功能后，每个生成任务将额外消耗 10 积分。
可选
resolution
string
分辨率，用于指定生成视频的清晰度。
VQ3-Pro、VQ3-Turbo：默认分辨率为 720p。支持选择 540p、720p 或 1080p。VQ2-Pro：默认分辨率为 720p。支持选择 540p、720p 或 1080p。VQ2-Turbo：默认分辨率为 720p。支持选择 540p、720p 或 1080p。
可选
seed
integer
随机种子。
当未传入种子或传入值为0时，系统将自动生成随机数作为种子，确保每次生成结果具有随机性。
用户可传入非零整数值作为固定种子，以实现结果的可复现性。
可选
bgm
boolean
是否为生成的视频添加背景音乐。默认值：false。
功能说明：传 true 时系统将从预设库中自动匹配并适配视频时长；不传或传 false 则不添加。系统将根据视频时长自动适配。
注：VQ3-Pro、VQ3-Turbo 模型不生效。
可选
audio
boolean
是否使用音视频直出能力，默认为 true
false：静音视频true：音画同步视频
注：仅VQ3-Pro、VQ3-Turbo模型支持。
可选
请求结构
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://example.com/test_image_1.jpg",
"https://example.com/test_image_2.jpg"
],
"prompt": "云朵快速流动，延时摄影效果"
}
}示例代码
请求示例
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://example.com/test_image_1.jpg",
"https://example.com/test_image_2.jpg"
],
"prompt": "云朵快速流动，延时摄影效果",
"duration": 5,
"resolution": "720p"
"seed": 999
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
log_id
string
日志ID，用于问题排查。
必选
task_id
string
任务ID，用于后续查询生成结果。
必选
status
string
任务状态，标识当前任务所处阶段。
created创建成功queueing任务排队中processing任务处理中success任务成功failed任务失败
必选
model
string
使用的模型名称。
必选
images
array
图像回显。
列表包含 2 个 URL，顺序为 [首帧图, 尾帧图]。
必选
显示子属性
隐藏子属性
items
string
prompt
string
输入的提示词内容。
必选
duration
integer
视频时长 (秒)。
可选
seed
integer
使用的随机种子。
可选
resolution
string
生成的视频分辨率。
可选
created_at
string
任务创建的时间，格式为时间戳字符串（毫秒级）。
必选
任务创建成功
{
"log_id": "as-mqgjiteu5p",
"task_id": "697b263828a819d37fce4d41",
"status": "created",
"model": "VQ2-Pro",
"images": [
"https://example.com/test_image_1.jpg",
"https://example.com/test_image_2.jpg"
],
"prompt": "云朵快速流动，延时摄影效果",
"duration": 5,
"seed": 999,
"resolution": "720p",
"created_at": "1769678392000"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| 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 |
评价此篇文章