kling-v3.0-std-motion-control

POST

/openapi/v2/kling-v3.0-std/motion-control

The motion control base version of Kuaishou's Kling V3.0 series, designed for users needing to transfer motion from reference videos to static images. Upload a character image and driving video to make the character accurately replicate dances, gestures, or movement trajectories from the video. Employs 3D Spacetime Joint Attention mechanism to achieve physically realistic motion transfer while preserving character identity. Supports dual orientation modes—"Image Mode" (up to 10s, maintaining original perspective) and "Video Mode" (up to 30s, following driving video perspective)—providing cost-effective motion generation for social media content, virtual presenters, and creative short videos.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "imageUrl": "https://www.runninghub.cn/view?filename=cb0b64d35648eff33fa2d725caf83d6593a6ee44ff0fe46d4b7cad400d7bd95a.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODUxOTg2MDIsInRzIjoxNzczMjgwMzk4NjAyLCJzaWduIjoiZDdmOTVmY2Q3NzA0NzIwNWQzZWI4YTY2YjkzMThmMGMifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.44360154753290404",
    "videoUrl": "https://www.runninghub.cn/view?filename=a02e57394f602b2dbc24c25d869c915f5abb89e5d1b1f50f7a2734546af4f5d4.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODUzOTM2OTAsInRzIjoxNzczMjgwNTkzNjkwLCJzaWduIjoiYTcxYmJjOTY4MDc2YTBiM2RlMmQ1NTg0MTA4MTc0YjgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7147349320086593",
    "characterOrientation": "video",
    "keepOriginalSound": true
}

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-v3.0-std/motion-control' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imageUrl": "https://www.runninghub.cn/view?filename=cb0b64d35648eff33fa2d725caf83d6593a6ee44ff0fe46d4b7cad400d7bd95a.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODUxOTg2MDIsInRzIjoxNzczMjgwMzk4NjAyLCJzaWduIjoiZDdmOTVmY2Q3NzA0NzIwNWQzZWI4YTY2YjkzMThmMGMifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.44360154753290404",
    "videoUrl": "https://www.runninghub.cn/view?filename=a02e57394f602b2dbc24c25d869c915f5abb89e5d1b1f50f7a2734546af4f5d4.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODUzOTM2OTAsInRzIjoxNzczMjgwNTkzNjkwLCJzaWduIjoiYTcxYmJjOTY4MDc2YTBiM2RlMmQ1NTg0MTA4MTc0YjgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7147349320086593",
    "characterOrientation": "video",
    "keepOriginalSound": true
}'

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-25 12:00:02

kling-v3.0-pro-motion-control

kling-v2.6-pro-motion-control