Video Effects

POST https://www.kkiai.com/kling/v1/videos/effects

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value is the Token concatenated after Bearer.

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

Header Parameters

Parameter Name	Type	Required	Description	Example
Content-Type	string	Optional		application/json
Authorization	string	Optional		Bearer {{YOUR_API_KEY}}

Body Parameters (application/json)

Parameter Name	Type	Required	Description
effect_scene	string	Required
input	object	Optional	Reference image. Supports Base64-encoded images or image URLs (must be accessible). Supports different input structures for different tasks. The fields in the structure vary by scene, as shown in "Scene Request Body"
└ model_name	string	Optional	Dual-person kling-v1, kling-v1-5, kling-v1-6
└ mode	string	Optional	Dual-person. Video generation mode; Enum values: std, pro; std: Standard mode (standard), basic mode, high cost-effectiveness; pro: Expert mode (high quality), high-performance mode, better video quality
└ duration	string	Optional
└ images	array[string]	Optional
└ image	string	Optional
callback_url	string	Optional
external_task_id	string	Optional

Request Example

{
    "effect_scene": "balloon_parade",
    "input": {
        "duration": "5",
        "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-op/effects_pic/balloon_parade.jpeg"
    },
    "callback_url": "",
    "external_task_id": ""
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/kling/v1/videos/effects' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "effect_scene": "balloon_parade",
    "input": {
        "duration": "5",
        "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-op/effects_pic/balloon_parade.jpeg"
    },
    "callback_url": "",
    "external_task_id": ""
}'

Response

🟢 200 Success

Response Example

{}