Kling Video Effects

curl --request POST \ --url https://api.modellix.ai/api/v1/kling/kling-video-effects \ --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": "model-123", "get_result": { "method": "GET", "url": "https://api.modellix.ai/api/v1/tasks/task-effects001" } } }

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Option 1
Option 2

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

Detailed data about the submitted asynchronous task.

Show child attributes