Task: Video Effects - Dual Interaction

Overview

• Method: POST
• Path: /kling/v1/videos/effects
• Content-Type: application/json
• Tags: Video Models (Video) / Kuaishou Keling AI

Authentication

• Header: Authorization: Bearer <token>

---

Key Parameters

Parameter	Type	Required	Description
effect_scene	string	Yes	Effect scene name: hug / kiss / heart_gesture. Different scenes use different effect logic, and required fields may vary.
input.images	array	Yes	Reference image group. Must include 2 images: the first is the left person, the second is the right person. Supports image URL or Base64 without data: prefix. Image formats: .jpg/.jpeg/.png; size <=10MB; resolution >=300x300; aspect ratio 1:2.5~2.5:1.
input.duration	string	Yes	Video duration in seconds, supports 5 or 10.
input.model_name	string	Yes	Request model: kling-v1 / kling-v1-5 / kling-v1-6.
input.mode	string	Yes	Video mode: std (standard, cost-effective) or pro (expert, higher quality).
callback_url	string	No	Task result callback URL. If configured, the server notifies status changes. See Callback Protocol for the schema.
external_task_id	string	No	User-defined task ID. The system does not override it. It supports lookup and must be unique per user.

---

Example Request Body

{
  "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"
  }
}

---

Success Response Example (200)

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