kling-elements

POST

/openapi/v2/kling-elements

A multi-element locking feature launched by Kuaishou Kling, designed specifically for video generation. Supports simultaneous locking of 1-4 visual elements across different categories—including human characters, animals, object props, and scene environments. After uploading reference images, the system extracts core features of each element and maintains their visual identity throughout video generation, ensuring consistent appearance regardless of camera movement or lighting changes. Control interactions between elements using prompt tags like "Figure 1/2/3" to achieve complex narratives such as character dialogues, animal performances, and object manipulations. Ideal for AI short dramas, virtual IP operations, product showcases, and creative storytelling requiring cross-shot consistency of multiple elements.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "name": "Gray Wool Business Suit",
    "description": "Tailored women's business suit in heather gray wool blend. Single-breasted blazer with notch lapels, two black buttons, flap pockets at hips and chest. Matching straight-leg trousers. Fabric shows subtle herringbone texture. Professional minimalist style suitable for corporate environment. Neutral color palette: gray, black, white.",
    "imageUrl": "https://www.runninghub.cn/view?filename=e5d6eba72968f46b681fba0f983208ec6b90bdbf61c2189800abc0f46ba689a3.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODc0OTU3NzIsInRzIjoxNzczMjgyNjk1NzcyLCJzaWduIjoiOTY1ZmVlMWMwZjBjZWY0ZjQ1MzdmYTI3OWVmNjQxMzcifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.12160626278480557",
    "elementReferList": [
        "https://www.runninghub.cn/view?filename=cbc7579016265a6e10f7d00bd4a6886daa6a0a186d14aee8037db5a59dc0a8ed.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODc0OTU3NzIsInRzIjoxNzczMjgyNjk1NzcyLCJzaWduIjoiOTY1ZmVlMWMwZjBjZWY0ZjQ1MzdmYTI3OWVmNjQxMzcifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.9373461976540858"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/kling-elements' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Gray Wool Business Suit",
    "description": "Tailored women'\''s business suit in heather gray wool blend. Single-breasted blazer with notch lapels, two black buttons, flap pockets at hips and chest. Matching straight-leg trousers. Fabric shows subtle herringbone texture. Professional minimalist style suitable for corporate environment. Neutral color palette: gray, black, white.",
    "imageUrl": "https://www.runninghub.cn/view?filename=e5d6eba72968f46b681fba0f983208ec6b90bdbf61c2189800abc0f46ba689a3.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODc0OTU3NzIsInRzIjoxNzczMjgyNjk1NzcyLCJzaWduIjoiOTY1ZmVlMWMwZjBjZWY0ZjQ1MzdmYTI3OWVmNjQxMzcifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.12160626278480557",
    "elementReferList": [
        "https://www.runninghub.cn/view?filename=cbc7579016265a6e10f7d00bd4a6886daa6a0a186d14aee8037db5a59dc0a8ed.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODc0OTU3NzIsInRzIjoxNzczMjgyNjk1NzcyLCJzaWduIjoiOTY1ZmVlMWMwZjBjZWY0ZjQ1MzdmYTI3OWVmNjQxMzcifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.9373461976540858"
    ]
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-03-24 12:00:02

kling-video-o3-std-image-to-video

kling-v2.5-turbo-std/image-to-video