Skip to main content
POST
/
kling-video-effects
/
async
curl --request POST \
  --url https://api.modellix.ai/api/v1/image-to-video/kling/kling-video-effects/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "effect_scene": "pet_lion_pro",
  "image": "https://example.com/image.jpg"
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-effects001",
    "model_id": "kling-video-effects"
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json
​
effect_scene
string
required

Effect scene name. Supports 212 video effects total: 208 single-image effects (e.g., pet_lion_pro, cute_dance, bullet_time) and 4 two-person effects (cheers_2026, fight_pro, hug_pro, heart_gesture_pro). For complete list, see: https://app.klingai.com/global/dev/document-api/quickStart/productIntroduction/effectsCenter

Minimum string length: 1
Example:

"pet_lion_pro"

​
image
string
required

Reference image for single-image effects. Supports URL or Base64 encoded string. Mutually exclusive with 'images' - use 'image' for single-image effects, 'images' for two-person effects. Supported formats: JPG/JPEG/PNG. Maximum file size: 10MB. Minimum resolution: 300x300px. Aspect ratio should be between 1:2.5 and 2.5:1. Do not include Base64 prefix.

Minimum string length: 1
Example:

"https://example.com/image.jpg"

​
images
string[]

Reference image array for two-person effects. Mutually exclusive with 'image'. Must contain exactly 2 images. The first image will be positioned on the left, the second on the right. Each image supports URL or Base64 encoding. Same format and size requirements as 'image'.

Required array length: 2 elements
Minimum string length: 1
Example:
[
  "https://example.com/image1.jpg",
  "https://example.com/image2.jpg"
]
​
duration
enum<integer>

Video duration in seconds: 5 or 10. Different effects may support different durations. Optional.

Available options:
5,
10
Example:

5

Response

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required