kling-v3.0-pro-motion-control

POST

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

The professional motion control version of the Kling V3.0 series, delivering comprehensive upgrades in image quality and motion accuracy over the Std tier. Upload a character image and driving video to make the character accurately replicate dances, gestures, or movement trajectories from the video. Employs the same 3D Spacetime Joint Attention architecture with Chain-of-Thought reasoning, but significantly enhances character detail preservation, motion fluidity, and physical realism. Supports 1080p high-resolution output with precise reproduction of clothing textures, facial expressions, and complex hand gestures. Dual-mode support (Image Mode 10s/Video Mode 30s) combined with audio preservation enables direct generation of fully synchronized audio-visual content. Ideal for cinematic-grade professional production, high-end commercial advertising, and IP character animation.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "imageUrl": "https://www.runninghub.cn/view?filename=89e02f18e6149305a20b5ed037c584efc4186103fb4c467c0976a3fd24604975.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODUzOTM2OTAsInRzIjoxNzczMjgwNTkzNjkwLCJzaWduIjoiYTcxYmJjOTY4MDc2YTBiM2RlMmQ1NTg0MTA4MTc0YjgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.39204052693314884",
    "videoUrl": "https://www.runninghub.ai/view?filename=042846788aa32fa27d400649097870363581d04698c3aa4fab88c7f449761a15.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiJhMjU3MjhjNDk5ZWRhMzY5NjBlNjBlZTIwMTc0MDYxOCIsInNpZ25FeHBpcmUiOjE3NzM4ODY3OTA2MDMsInRzIjoxNzczMjgxOTkwNjAzLCJzaWduIjoiNWFmMzY0NDJmMTE4MmU0ZjRjYjlhNmE5NjgwYmI1MGIifQ==&Rh-Identify=a25728c499eda36960e60ee201740618&rand=0.9683182098699739",
    "characterOrientation": "video",
    "keepOriginalSound": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.runninghub.ai/openapi/v2/kling-v3.0-pro/motion-control' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data '{
    "imageUrl": "https://www.runninghub.cn/view?filename=89e02f18e6149305a20b5ed037c584efc4186103fb4c467c0976a3fd24604975.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM4ODUzOTM2OTAsInRzIjoxNzczMjgwNTkzNjkwLCJzaWduIjoiYTcxYmJjOTY4MDc2YTBiM2RlMmQ1NTg0MTA4MTc0YjgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.39204052693314884",
    "videoUrl": "https://www.runninghub.ai/view?filename=042846788aa32fa27d400649097870363581d04698c3aa4fab88c7f449761a15.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiJhMjU3MjhjNDk5ZWRhMzY5NjBlNjBlZTIwMTc0MDYxOCIsInNpZ25FeHBpcmUiOjE3NzM4ODY3OTA2MDMsInRzIjoxNzczMjgxOTkwNjAzLCJzaWduIjoiNWFmMzY0NDJmMTE4MmU0ZjRjYjlhNmE5NjgwYmI1MGIifQ==&Rh-Identify=a25728c499eda36960e60ee201740618&rand=0.9683182098699739",
    "characterOrientation": "video",
    "keepOriginalSound": true
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Bodyapplication/json

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-05-07 10:50:28

bytedance/dreamactor-v2

kling-v2.6-pro-motion-control