Docs/Kling Effects API

Kling Effects API

136+ creative video effects including holiday themes, dynamic effects, and style transforms. Apply effects to photos for stunning video output.

Quick Start

Get your API key from the Console

Choose an effect scene

Send POST request to create task

Poll GET request for video result

Authentication

Add Authorization header with Bearer token to all requests:

Authorization: Bearer YOUR_API_KEY

Available Model

Model	API Name	Features
Kling Effects	`kling-effects`	136+ creative video effects, single & dual person support

Pricing (85% off)

Category	$	Examples
Ultra Low	$0.0106	`pet_lion, pet_cat, pet_dog`
Low	$0.0181	`santa_gift`
Medium (base)	$0.0214	`santa_express, balloon_parade`
Medium-High	$0.0373	`bloombloom, dizzydizzy, face_warp`
High	$0.0425	`happy_birthday, birthday_cake`
Ultra High	$0.0745	`bullet_time`

Endpoints

POST/api/v1/video/generations

Create a Kling effects video generation task. Applies a creative effect to one or two person photos.

GET/api/v1/video/generations?task_id=xxx

Query task status and get video URL

Request Parameters

modelrequiredstring

"kling-effects"

effect_scenerequiredstring

Effect scene name, e.g. "balloon_parade", "happy_birthday", "bullet_time"

inputrequiredobject

Input object containing image(s) and options

callback_urlstring

Webhook URL for completion notification

input Object Fields

imagestring

Single person photo URL or base64 (for single-person effects)

imagesarray

Array of image URLs or base64 strings (for dual-person effects)

model_namestring

Model name for dual effects, e.g. "kling-v1-6"

modestring

"std" or "pro" for dual effects

durationstring

Video duration in seconds

Code Examples

curl -X POST https://apimodels.app/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-effects",
    "effect_scene": "balloon_parade",
    "input": {
      "image": "https://example.com/person.jpg"
    }
  }'

Response Format

Create Task Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "pending",
    "model": "kling-video/kling-effects"
  }
}

Success Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "completed",
    "model": "kling-video/kling-effects",
    "resultUrls": ["https://...video.mp4"],
    "createTime": 1705123450000,
    "completeTime": 1705123500000
  }
}

Failed Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "clxxx...",
    "state": "failed",
    "model": "kling-video/kling-effects",
    "failMsg": "Content policy violation"
  }
}

Task States

pendingTask queued, waiting to process

processingVideo is being generated

completedVideo generation successful

failedVideo generation failed

Error Codes

400Bad Request - Missing or invalid parameters

401Unauthorized - Invalid API key

402Payment Required - Insufficient credits

404Not Found - Task ID not found

500Internal Server Error

Important Notes

*Video files are stored for 7 days, download promptly
*136+ effects available across holiday, dynamic, and style categories
*Single-person effects use the "image" field, dual-person effects use the "images" array
*Pricing varies by effect category, from $0.0106 to $0.0745
*Poll every 5-10 seconds to check status
*Effect scene names are case-sensitive

Try in Playground Get API Key

Model

API Name

Features

Kling Effects

kling-effects

136+ creative video effects, single & dual person support

Category

Examples

Ultra Low

$0.0106

pet_lion, pet_cat, pet_dog

Low

$0.0181

santa_gift

Medium (base)

$0.0214

santa_express, balloon_parade

Medium-High

$0.0373

bloombloom, dizzydizzy, face_warp

High

$0.0425

happy_birthday, birthday_cake

Ultra High

$0.0745

bullet_time

Code Examples

curl -X POST https://apimodels.app/api/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-effects",
    "effect_scene": "balloon_parade",
    "input": {
      "image": "https://example.com/person.jpg"
    }
  }'

Response Format

Create Task Response

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "pending", "model": "kling-video/kling-effects" } }

Success Response

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "completed", "model": "kling-video/kling-effects", "resultUrls": ["https://...video.mp4"], "createTime": 1705123450000, "completeTime": 1705123500000 } }

Failed Response

{ "code": 200, "msg": "success", "data": { "taskId": "clxxx...", "state": "failed", "model": "kling-video/kling-effects", "failMsg": "Content policy violation" } }

Important Notes

*Video files are stored for 7 days, download promptly

*136+ effects available across holiday, dynamic, and style categories

*Single-person effects use the "image" field, dual-person effects use the "images" array

*Pricing varies by effect category, from $0.0106 to $0.0745

*Poll every 5-10 seconds to check status

*Effect scene names are case-sensitive