创建视频生成任务-图生视频
根据输入的一张首帧图像和文本提示词生成视频,返回task_id用于后续查询结果。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
模型名称。
支持值:K1、K1.6、K2.0、K2.1、K2.1-Master、K2.5-Turbo、K2.6。
任务类型。
固定值:img2video。
模型参数配置。
显示子属性
隐藏子属性
正向提示词,用于描述视频内容。
长度限制:最大 2500 字符。
注:K2.6 模型暂不支持在 Prompt 中指定音色。
负向提示词,用于描述不希望出现的画面内容。
长度限制:最大 2500 字符。
音频生成开关。
默认值:off
枚举值:
● on:开启音频生成。
● off:关闭音频生成。
仅 K2.6 及后续版本模型支持。
视频时长(秒)。
枚举值:5、10
视频生成模式,控制生成质量与耗时的平衡。
枚举值:
● std:标准模式,兼顾生成速度与质量。
● pro:专业模式,优先保证视频细节与质量。
注:具体模型支持情况请参考能力地图。
首帧参考图像。
数据格式:支持 HTTP URL 或 Base64 编码字符串。
格式约束:
● Base64 编码不可包含头部前缀(如 data:image/png;base64,)。
● 文件格式支持 .jpg / .jpeg / .png。
● 文件大小 ≤ 10MB。
● 分辨率 ≥ 300x300px。
● 宽高比范围:1:2.5 ~ 2.5:1。
尾帧参考图像(用于首尾帧控制)。
格式同 image 参数。
指定音色列表。
一次视频生成任务最多包含 2 个音色 ID。
计费说明:若列表非空且 prompt 中引用了对应音色,将按指定音色计费。
仅 K2.6 及后续版本模型支持。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
音色 ID。
需使用系统预置音色 ID或音色定制接口返回的 ID。
注:不支持对口型API的voice_id。
提示词相关性系数。取值范围:[0, 1] 默认值:0.5
值越高,生成内容越严格遵循提示词,创意自由度相应降低;
值越低,模型发挥空间越大,结果更具创造性但可能偏离提示。
静态笔刷区域。定义在整个视频序列中保持不变的编辑区域
格式约束:同 image 参数。
图片格式:.jpg、.jpeg、.png
逻辑约束:分辨率及长宽比必须与image 完全一致。
若同时使用dynamic_masks,则static_mask与dynamic_masks.mask的分辨率必须相同。
注:具体模型支持情况请参考能力地图。
动态笔刷配置列表。
最多支持 6 组配置。
注:具体模型支持情况请参考能力地图。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
动态笔刷涂抹区域。
格式约束:同 image 参数。
图片格式:.jpg、.jpeg、.png
逻辑约束:分辨率必须与 image 及 static_mask 保持一致。
运动轨迹坐标序列。
坐标个数取值范围:[2, 77](针对 5s 视频)。
以数组首个坐标为起点,按序连接形成轨迹。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
轨迹点 X 坐标(像素坐标系,以图片左下角为原点)。
轨迹点 Y 坐标(像素坐标系,以图片左下角为原点)。
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "K2.6",
"type": "img2video",
"model_parameters": {
"prompt": "高清,电影质感,阳光洒在海面上,波光粼粼",
"image": "https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg",
"negative_prompt": "模糊,变形,低质量",
"duration": "5",
"mode": "pro",
"cfg_scale": 0.7,
"sound": "on"
}
}
示例代码
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": "K2.6",
"type": "img2video",
"model_parameters": {
"prompt": "高清,电影质感,阳光洒在海面上,波光粼粼",
"image": "https://qianfan-doc.bj.bcebos.com/image_test/test_image_1.jpg",
"negative_prompt": "模糊,变形,低质量",
"duration": "5",
"mode": "pro",
"cfg_scale": 0.7,
"sound": "on"
}
}'
返回响应
错误码。
错误信息。
请求ID。
返回数据体,包含任务相关信息。
显示子属性
隐藏子属性
任务ID。
任务状态。
submitted:已提交processing:处理中succeed:成功failed:失败
任务创建时间,Unix 时间戳(毫秒)。
任务更新时间,Unix 时间戳(毫秒)。
任务详细信息。
显示子属性
隐藏子属性
{
"code": 0,
"message": "",
"request_id": "as-fde7tzq1g2",
"data": {
"task_id": "6981c8dfddc501bca6a09f08",
"task_status": "submitted",
"created_at": 1770113247000,
"updated_at": 1770113247000,
"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 |
