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

概览

• 请求方法：POST
• 路径：/kling/v1/videos/effects
• 内容类型：application/json
• Tags：视频模型（Video）/快手可灵AI

认证

• Header: Authorization: Bearer <token>

---

关键参数

参数	类型	必填	描述
effect_scene	string	是	特效场景名称：hug/ kiss/ heart_gesture。根据 effect_scene 实现不同的特效，不同场景输入字段可能不同。
input.images	string	是	参考图像组。数组长度必须为2，第一张为合照左边，第二张为合照右边。支持图片URL或Base64（不带data:前缀）。图片格式.jpg/.jpeg/.png；大小≤10MB，分辨率≥300x300，宽高比1:2.5~2.5:1。
input.duration	string	是	视频时长，单位秒，支持 '5' 或 '10'。
input.model_name	string	是	请求模型：kling-v1 / kling-v1-5 / kling-v1-6。
input.mode	string	是	视频模式：std（标准，性价比高）或 pro（专家，高品质，生成质量更优）。
callback_url	string	否	任务结果回调通知地址，如果配置，服务端状态变更时会通知，具体 schema 见“Callback 协议”。
external_task_id	string	否	用户自定义任务 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",
    "mode": "std"
  }
}

---

返回示例（200）

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "...",
  "data": {
    "task_id": "...",
    "task_status": "submitted",
    "created_at": 173..., 
    "updated_at": 173...
  }
}