可灵动作控制V3.0-std

POST

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

快手可灵V3.0系列的动作控制基础版本，专为需要将参考视频中的动作迁移到静态图片的用户设计。通过上传角色图片与驱动视频，即可让图片中的角色精准复现视频中的舞蹈、手势或运动轨迹。采用3D时空联合注意力机制，在保持角色身份特征的同时实现物理真实的动作转移。支持"图片模式"（最长10秒，保持原图视角）与"视频模式"（最长30秒，跟随驱动视频视角）双模式，为社交媒体内容、虚拟主播和创意短视频提供高性价比的动作生成方案。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "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
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.cn/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
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Body

示例

提交任务响应示例任务完成（查询状态接口）响应示例

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

修改于 2026-03-25 12:00:02

可灵动作控制V3.0-pro

kling-v2.6-pro-动作控制