创建视频生成任务-首尾帧生视频
更新时间：2026-02-12
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
本接口根据首帧图和尾帧图生成过渡自然的视频，返回task id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型名称。
支持值：KO1。
必选
type
string
任务类型。
固定值：omni-video。
必选
model_parameters
object {6}
模型参数配置。
必选
显示子属性
隐藏子属性
prompt
string
文本提示词，包含正向描述与负向描述。
长度限制：最大 2500 字符。
支持通过 <<<标识符>>> 的格式在提示词中引用指定的主体、图片，以实现精准控制。
- 引用主体：<<<element_1>>>
- 引用图片：<<<image_1>>>
必选
image_list
array
首尾帧图片列表。用于控制视频生成的视觉内容。
- 格式：
.jpg/.jpeg/.png - 大小：≤ 10MB
- 尺寸：宽或高 ≥ 300px，图片宽高比范围 1:2.5 ~ 2.5:1
参考图片数量不得超过 7 张。
若设置尾帧图，仅支持传入 2 张参考图（首帧+尾帧），且尾帧依赖首帧，不可单独传入尾帧图。
必选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
image_url
string
图片 URL（需公网可访问）或 Base64 编码。
必选
type
string
图片类型。
枚举值：
first_frame：首帧图end_frame：尾帧图
必选
element_list
array
主体参考列表，用于引用主体库中的特定角色或物体，通过element_id实现视频生成中的主体一致性。
限制：主体数量 + 参考图数量 ≤ 7
可选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
element_id
integer
主体 ID。
可选
mode
string
视频生成模式。默认值：pro。
std（标准模式）：适合日常使用，性价比高。pro（专业模式）：适合对画质有较高要求的场景，生成视频质量更佳。
可选
aspect_ratio
string
画面比例。
指定生成视频的宽高比。
支持：16:9（横屏）、9:16（竖屏）、1:1（方形）。
注：未使用首帧参考图时，此参数必填。
可选
duration
string
视频时长。
指定生成视频的时长，单位为秒（s）。 默认5秒。
枚举值：5、10。
可选
请求结构
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"type": "omni-video",
"model": "KO1",
"model_parameters": {
"prompt": "电影镜头，<<<element_1>>> 站在城市边缘，从白昼逐渐过渡到黑夜，光影流转。",
"element_list": [
{
"element_id": 1001
}
],
"image_list": [
{
"image_url": "https://example.com/day_start.jpg",
"type": "first_frame"
},
{
"image_url": "https://example.com/night_end.jpg",
"type": "end_frame"
}
],
"duration": "5",
"mode": "pro"
}
}示例代码
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 '{
"type": "omni-video",
"model": "KO1",
"model_parameters": {
"prompt": "电影镜头，<<<element_1>>> 站在城市边缘，从白昼逐渐过渡到黑夜，光影流转。",
"element_list": [
{
"element_id": 1001
}
],
"image_list": [
{
"image_url": "https://your-domain.com/real-day-image.jpg",
"type": "first_frame"
},
{
"image_url": "https://your-domain.com/real-night-image.jpg",
"type": "end_frame"
}
],
"duration": "5",
"mode": "pro"
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码。
必选
message
string
错误信息。
必选
request_id
string
请求ID。
必选
data
object {5}
返回数据体，包含任务相关信息。
必选
显示子属性
隐藏子属性
task_id
string
任务ID。
必选
task_status
string
任务状态。
submitted：已提交processing：处理中succeed：成功failed：失败
必选
created_at
integer
任务创建时间，Unix 时间戳（毫秒）。
必选
updated_at
integer
任务更新时间，Unix 时间戳（毫秒）。
必选
task_info
object
任务详细信息。
必选
显示子属性
隐藏子属性
json
{
"code": 0,
"message": "",
"request_id": "as-mijgsbtzvd",
"data": {
"task_id": "698d4c93ee577eeea76d3aa7",
"task_status": "submitted",
"created_at": 1770867859000,
"updated_at": 1770867859000,
"task_info": {}
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 0 | 请求成功 | - | - |
| 1100 | 账户异常 | 账户异常 | 检查账户配置信息 |
| 1200 | 请求参数非法 | 请求参数非法 | 检查请求参数是否正确 |
| 1201 | 请求参数非法 | 参数非法，如key写错或value非法 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1202 | 请求参数非法 | 请求的method无效 | 查看接口文档，使用正确的request method |
| 1203 | 请求参数非法 | 请求的资源不存在，如模型 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1300 | 触发策略 | 触发平台策略 | 检查是否触发平台策略 |
| 1301 | 触发策略 | 触发平台的内容安全策略 | 检查输入内容，修改后重新发起请求 |
| 5000 | 内部错误 | 服务器内部错误 | 稍后重试，或联系客服 |
| 5001 | 内部错误 | 服务器暂时不可用，通常是在维护 | 稍后重试，或联系客服 |
| 5002 | 内部错误 | 服务器内部超时，通常是发生积压 | 稍后重试，或联系客服 |
视频模型通用错误码
| 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 |