创建图生视频任务
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
用于生成视频的模型，目前支持模型：kling-v1, kling-v1-5, kling-v1-6, kling-v2-master, kling-v2-1, kling-v2-1-master
正向文本提示词，最大2500字符
负向文本提示词，最大2500字符
参考图像，说明：
（1）支持传入图片Base64编码或图片URL（确保可访问）
（2）若使用base64方式，传递的所有图像数据参数均采用Base64编码格式。在提交数据时，正确的参数格式是Base64编码后的字符串，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,示例如下：
· 正确的Base64编码参数：iVBORw0KGgoAAAA***
· 错误的Base64编码参数（包含data:前缀）：data:image/png;base64,iVBORw0KGgoAAAA***
（3）图片格式支持 .jpg、.jpeg 或 .png
（4）图片文件大小不能超过10MB，图片分辨率不小于300*300px，图片宽高比要在1:2.5 ~ 2.5:1之间
参考图像 - 尾帧控制，说明：
（1）支持传入图片Base64编码或图片URL（确保可访问）
（2）若使用base64方式，传递的所有图像数据参数均采用Base64编码格式。在提交数据时，正确参数格式是Base64编码后的字符串，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,示例如下：
· 正确的Base64编码参数：iVBORw0KGgoAAAA***
· 错误的Base64编码参数（包含data:前缀）：data:image/png;base64,iVBORw0KGgoAAAA***
（3）图片格式支持 .jpg、.jpeg 或 .png
（4）图片文件大小不能超过10MB，图片分辨率不小于300*300px
（5）不同模型版本、视频模式支持范围不同，详见能力地图
生成视频的自由度，说明：
（1）值越大，模型自由度越小，与用户输入的提示词相关性越强
（2）取值范围：[0, 1]，默认0.5
（3）不同模型版本、视频模式支持范围不同，详见能力地图
生成视频的模式，说明：
（1）可选值如下：
· std：标准模式（标准），基础模式，性价比高
· pro：专家模式（高品质），高表现模式，生成视频质量更佳
（2）不同模型版本、视频模式支持范围不同，详见能力地图
静态笔刷涂抹区域，用户通过运动笔刷涂抹的 mask 图片，说明：
（1） 支持传入图片Base64编码或图片URL，确保可访问，格式要求同 image 字段
（2） 图片格式支持.jpg、.jpeg 或 .png
（3） 图片长宽比必须与输入图片相同，即image字段，否则任务失败
（4） static_mask 和 dynamic_masks.mask 这两张图片的分辨率必须一致，否则任务失败
（5）不同模型版本、视频模式支持范围不同，详见能力地图
动态笔刷配置列表，说明：
（1）可配置多组（最多6组）
（2）每组包含“涂抹区域 mask”与“运动轨迹 trajectories”序列
（3）不同模型版本、视频模式支持范围不同，详见能力地图
显示子属性
隐藏子属性
显示子属性
隐藏子属性
动态笔刷涂抹区域，用户通过运动笔刷涂抹的 mask 图片，说明：
（1）支持传入图片Base64编码或图片URL，确保可访问，格式要求同 image 字段
（2） 图片格式支持.jpg、.jpeg 或 .png
（3） 图片长宽比必须与输入图片相同，即image字段，否则任务失败
（4）static_mask 和 dynamic_masks.mask 这两张图片的分辨率必须一致，否则任务失败
运动轨迹坐标序列，说明：
（1）生成5s的视频，轨迹长度不超过77，即坐标个数取值范围：[2, 77]
（2）轨迹坐标系，以图片左下角为坐标原点
（3）坐标点个数越多轨迹刻画越准确，如只有2个轨迹点则为这两点连接的直线
（4）轨迹方向以传入顺序为指向，以最先传入的坐标为轨迹起点，依次链接后续坐标形成运动轨迹
显示子属性
隐藏子属性
显示子属性
隐藏子属性
轨迹点横坐标，在像素二维坐标系下，以输入图片image左下为原点的像素坐标
轨迹点纵坐标，在像素二维坐标系下，以输入图片image左下为原点的像素坐标
生成视频时长，单位s，可选值：5，10
POST /beta/video/generations/kling/image2video HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model_name": "kling-v1-6",
"mode": "pro",
"duration": "5",
"image": "https://h2.inkwai.com***",
"prompt": "宇航员站起身走了",
"cfg_scale": 0.5
}示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/kling/image2video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"model_name": "kling-v1-6",
"mode": "pro",
"duration": "5",
"image": "https://h2.inkwa***",
"prompt": "宇航员站起身走了",
"cfg_scale": 0.5
}'返回响应
错误码
错误信息
请求ID，系统生成，用于跟踪请求、排查问题
返回相关信息
显示子属性
隐藏子属性
视频生成异步任务的任务id
任务状态，说明：
· submitted：已提交
· processing：处理中
· succeed：成功
· failed：失败
任务创建时间，说明：Unix时间戳，单位ms
任务更新时间，说明：Unix时间戳，单位ms
{
"code": 0,
"message": "",
"request_id": "as-8jhimhhqhy",
"data": {
"task_id": "67adbb3b5b5ab6927a33478f",
"task_status": "submitted",
"created_at": 1739438907194,
"updated_at": 1739438907194
}
}错误码
如果请求错误，请查看错误码说明。