Kling Effects

POST

https://api.piapi.ai/api/v1/task

This is the api for Kling's Effects,

0.26 (s t d m o d e) /

0.46(pro mode) for each output video for for PAYG.

Notice
These effects must input prompt: rocket,hearting,fighting,kissing,hugging,birthday,water. Otherwise, it is very likely to fail on generation.

For birthday effect, input image should contain one human/dog/cat.

For water effect, input image should contain one human.

Request

Header Params

x-api-key

string

required

you api key

Body Params application/json

model

string

required

should be kling

Default:

kling

task_type

string

required

should be effects

Default:

effects

input

object

required

the input param of the task

image_url

string

required

the image url used to generate video

effect

enum<string>

required

effect name

Allowed values:

squishexpansionjellycat_overseaspinoffrocketheartingfightingkissinghuggingfigurevstackbirthdaywatersurfing

prompt

string

optional

text prompt used to generate video for some effects. Required by effects: rocket,hearting,fighting,kissing,hugging,birthday,water.

professional_mode

boolean

optional

use pro mode for some effects if true. default is std mode

Default:

false

config

object

optional

webhook_config

object

optional

Webhook provides timely task notifications. Check PiAPI webhook for detail.

service_mode

enum<string>

optional

This allows users to choose whether this specific task will get processed under PAYG or HYA mode. If unspecified, then this task will get processed under whatever mode (PAYG or HYA)
the user chose on the workspace setting of your account.

public means this task will be processed under PAYG mode.

private means this task will be processed under HYA mode.

Allowed values:

publicprivate

Example

{
    "model": "kling",
    "task_type": "effects",
    "input": {
        "image_url": "string",
        "effect": "squish",
        "prompt": "string",
        "professional_mode": false
    },
    "config": {
        "webhook_config": {
            "endpoint": "string",
            "secret": "string"
        },
        "service_mode": "public"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "kling",
    "task_type": "effects",
    "input": {
        "image_url": "string",
        "effect": "squish",
        "prompt": "string",
        "professional_mode": false
    },
    "config": {
        "webhook_config": {
            "endpoint": "string",
            "secret": "string"
        },
        "service_mode": "public"
    }
}'

Responses

🟢200Success

application/json

Body

object {0}

Example

{}

Modified at 2025-07-02 07:04:07

Kling Virtual Try-On

Kling Sound