创建多图参考生视频任务
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
模型名称,固定值为kling-v1-6,如果不填默认为kling-v1-6
参考图像列表,说明:
(1)最多支持4张图片,格式为key:value
(2)API端无裁剪逻辑,请直接上传已选主体后的图片
(3)支持传入图片Base64编码或图片URL(确保可访问);需注意,若使用base64方式,传递的所有图像数据参数均采用Base64编码格式。在提交数据时,正确的参数格式是Base64编码后的字符串,请不要在Base64编码字符串前添加任何前缀,例如data:image/png;base64,
· 正确的Base64编码参数示例:iVBORw0KGg***
· 错误的Base64编码参数(包含data:前缀)示例:data:image/png;base64,iVBORw0KGg***
(3)图片格式支持.jpg 、.jpeg 或 .png
(4)图片文件大小不能超过10MB,图片分辨率不小于200*200px,图片宽高比要在1:2.5 ~ 2.5:1之间
显示子属性
隐藏子属性
正向文本提示词,不能超过2500个字符
负向文本提示词,不能超过2500个字符
生成视频的模式,说明:
(1)可选值:
· std:标准模式(标准),基础模式,性价比高
· pro:专家模式(高品质),高表现模式,生成视频质量更佳
(2)不同模型版本、视频模式支持范围不同,详见能力地图
生成视频时长,单位s,可选值:5,10
生成图片的画面纵横比(宽:高),可选值:
· 16:9
· 9:16
· 1:1
自定义任务ID,说明:
(1)用户自定义任务ID,传入不会覆盖系统生成的任务ID,但支持通过该ID进行任务查询
(2)请注意,单用户下需要保证唯一性
POST /beta/video/generations/kling/multi-image2video HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model_name": "kling-v1-6",
"image_list": [
{
"image": "https://p2-kli***"
},
{
"image": "https://p2-kli***"
}
],
"prompt": "将两个图片合并到一起"
}
示例代码
curl 'https://qianfan.baidubce.com/beta/video/generations/kling/multi-image2video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"model_name": "kling-v1-6",
"image_list": [
{
"image": "https://p2-kling.kling***"
},
{
"image": "https://p2-kling.klinga***"
}
],
"prompt": "将两个图片合并到一起"
}'
返回响应
错误码,具体定义见错误码
错误信息
请求ID,系统生成,用于跟踪请求、排查问题
返回数据
显示子属性
隐藏子属性
任务ID,系统生成
任务状态,说明:
· submitted:已提交
· processing:处理中
· succeed:成功
· failed:失败
任务创建时间,说明:Unix时间戳、单位ms
任务更新时间,说明:Unix时间戳、单位ms
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"code": 0,
"message": "",
"request_id": "as-8jhimhhqhy",
"data": {
"task_id": "67adbb***a33478f",
"task_status": "submitted",
"created_at": 1739438907194,
"updated_at": 1739438907194
}
}
错误码
如果请求错误,请查看错误码说明。
