任务：视频特效-双人互动

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

根据 effect_scene 实现不同的特效效果。 - 单图特效：fuzzyfuzzy、squish、expansion - 双人互动特效：hug、kiss、heart_gesture

effect_scene

enum<string>

场景名称

必需

特效场景名称

枚举值:

hugkissheart_gesture

input

object

任务输入结构体

必需

支持不同任务输入的结构体。根据 scene 不同，结构体里传的字段不同，具体见「场景请求体」说明。

model_name

enum<string>

模型名称

可选

请求模型

枚举值:

kling-v1kling-v1-5kling-v1-6

images

string

必需

参考图像组

数组的长度必须是2，上传的第一张图在合照的左边，上传的第二张图在合照的右边
该服务包含合照功能，即用户上传两张人想图，可灵AI将自适应拼接为合照，如图所示先后上传
"https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
"https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
得到合照的效果为：

支持传入图片Base64编码或图片URL（确保可访问）
请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。
示例：
正确的Base64编码参数：
1
iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
错误的Base64编码参数（包含data:前缀）：
1
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。
图片格式支持.jpg / .jpeg / .png
图片文件大小不能超过10MB，图片分辨率不小于300*300px，图片宽高比要在1:2.5 ~ 2.5:1之间

duration

enum<string>

视频时长

必需

单位秒

枚举值:

510

mode

string

视频模式

必需

枚举值：std，pro
其中std：标准模式（标准），基础模式，性价比高
其中pro：专家模式（高品质），高表现模式，生成视频质量更佳

callback_url

string

任务结果回调通知地址

可选

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知。具体通知的消息 schema 见“Callback 协议”。

external_task_id

string

自定义任务 ID

可选

用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询。单用户下需要保证唯一性。

示例

{
  "effect_scene": "kiss",
  "input": {
    "model_name": "kling-v1-6",
    "images": [
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
    ],
    "duration": "5"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码；具体定义见错误码

message

string

错误信息

必需

request_id

string

必需

请求ID，系统生成，用于跟踪请求、排查问题

data

object

必需

task_id

string

任务ID，系统生成

必需

task_info

object

必需

任务创建时的参数信息

task_status

string

必需

任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）

created_at

integer

必需

任务创建时间，Unix时间戳、单位ms

updated_at

integer

必需

任务更新时间，Unix时间戳、单位ms

示例

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
  	"task_id": "string", //任务ID，系统生成
    "task_info":{ //任务创建时的参数信息
       "external_task_id": "string" //客户自定义任务ID
    }, 
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}