创建视频特效任务
创建一个视频特效任务
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
场景名称，可选值：
· bloombloom
· dizzydizzy
· fuzzyfuzzy
· squish
· expansion
· hug
· kiss
· heart_gesture
多选一，只需要符合下列任意一组子节点
支持不同任务输入的结构体，说明：根据scene不同，结构体里传的字段不同
显示子属性
隐藏子属性
单图特效，说明：支持5种，花花世界bloombloom、魔力转圈圈dizzydizzy、快来惹毛我fuzzyfuzzy、捏捏乐squish、万物膨胀expansion
显示子属性
隐藏子属性
模型名称，说明：固定值kling-v1-6
参考图像，说明：
（1）支持传入图片Base64编码或图片URL（确保可访问），注意：若使用base64方式，传递的所有图像数据参数均采用Base64编码格式。在提交数据时，正确的参数格式应该直接是Base64编码后的字符串，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,
· 正确的Base64编码参数示例：iVBORw0KGgoAAAANSUhE***
· 错误的Base64编码参数（包含data:前缀）示例：data:image/png;base64,iVBORw0KGgoAAAANSUhE***
（2）图片格式支持.jpg、.jpeg 或 .png
（3）图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间
生成视频时长，单位s，可选值：5
双人互动特效，说明：支持3种，拥抱hug、亲吻kiss、比心heart_gesture
显示子属性
隐藏子属性
模型名称，可选值如下：
· kling-v1
· kling-v1-5
· kling-v1-6
生成视频的模式，可选值如下：
· std：标准模式（标准），基础模式，性价比高；默认为std
· pro：专家模式（高品质），高表现模式，生成视频质量更佳
参考图像组，说明：
（1）数组的长度必须是2，上传的第一张图在合照的左边，上传的第二张图在合照的右边
（2）支持传入图片Base64编码或图片URL（确保可访问），注意：若使用base64方式，传递的所有图像数据参数均采用Base64编码格式。在提交数据时，正确的参数格式应该直接是Base64编码后的字符串，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,
· 正确的Base64编码参数示例：iVBORw0KGgoAAAANSUhE***
· 错误的Base64编码参数（包含data:前缀）示例：data:image/png;base64,iVBORw0KGgoAAAANSUhE***
（3）图片格式支持.jpg、.jpeg 或 .png
（4）图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间
显示子属性
隐藏子属性
生成视频时长，单位s，可选值：5，10
自定义任务ID，说明：
（1）用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询
（2）请注意，单用户下需要保证唯一性
POST /beta/video/generations/kling/effects HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"effect_scene": "hug",
"input":{
"model_name": "kling-v1-6",
"mode": "std",
"images":[
"https://p2-kling.klingai***",
"https://p2-kling.kl***"
],
"duration": "5"
}
}示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/kling/lipsync' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"effect_scene": "hug",
"input":{
"model_name": "kling-v1-6",
"mode": "std",
"images":[
"https://p2-kling.klin***",
"https://p2-kling.klinga***"
],
"duration": "5"
}
}'返回响应
错误码，具体定义见错误码
错误信息
请求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": "67adbb3b5b5ab6927a33478f",
"task_status": "submitted",
"created_at": 1739438907194,
"updated_at": 1739438907194
}
}错误码
如果请求错误，请查看错误码说明。