effects

POST

https://api.cometapi.com/kling/v1/videos/effects

Maintainer:Not configured

This document is not updated in real time, for the full version please check the official document: https://docs.qingque.cn/d/home/eZQClW07IFEuX1csc-VejdY2M

Request

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Body Params application/json

effect_scene

enum<string>

required

Scene name

Allowed values:

fuzzyfuzzysquishexpansionhugkissheart_gesture

input

required

One of

object

Single image effect

object (Single image effect)

required

Applicable to fuzzyfuzzy, squish, expansion scenes

callback_url

string

required

Callback notification address for this task result. If configured, the server will proactively notify when the task status changes

external_task_id

string

required

Custom task ID. User-defined task ID will not override the system-generated task ID, but supports task queries through this ID. Please note that uniqueness must be ensured under a single user

Examples

Example 1Example 2

{
    "effect_scene": "hug",
    "input": {
        "model_name": "kling-v1-6",
        "mode": "std",
        "images": [
            "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
            "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
        ],
        "duration": "10"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Example 1Example 2

curl --location --request POST 'https://api.cometapi.com/kling/v1/videos/effects' \
--header 'Authorization: Bearer {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "effect_scene": "hug",
    "input": {
        "model_name": "kling-v1-6",
        "mode": "std",
        "images": [
            "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
            "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
        ],
        "duration": "10"
    }
}'

Responses

🟢200Successful Response

application/json

Body

code

integer

required

Error code; specific error code definition

message

string

required

Error message

request_id

string

required

Request ID, system generated, used for tracking requests and troubleshooting issues

data

object

required

task_id

string

required

Task ID, system generated

task_status

string

required

Task status, enumeration values: submitted, processing, succeed, failed

created_at

integer

required

Task creation time, Unix timestamp, unit ms

updated_at

integer

required

Task update time, Unix timestamp, unit ms

Example

{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}

lip sync

Individual queries (videos)