即梦/动作模仿2.0

POST

/openapi/v2/bytedance/dreamactor-v2

作为字节跳动最新一代视频动作捕捉与迁移模型，它彻底颠覆了静态图像的边界。只需提供一张任意风格的图像与一段参考视频，即可让图片中的角色完美复刻视频中的肢体运动、面部微表情与精准口型。模型不仅支持全画幅真人驱动，更首次突破性地兼容多人同框、二次元动漫及宠物动作迁移。它具备极致的特征锁定能力，在生成流畅自然、高度同步的复杂动作时，能完美保持原图的画幅、姿态及背景细节，实现零门槛的电影级动画演绎。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "imageUrl": "https://www.runninghub.cn/view?filename=6c3cad40b41faebf770886a43798285681c9b4690de61aefb520e6f9d7bc22da.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzQyMzI3NzYxNTIsInRzIjoxNzczNjI3OTc2MTUyLCJzaWduIjoiZTFlZmY5OTgxMmZiODhkM2NiNzc3YzNkODEyNjgyNTgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.010155512076242101",
    "videoUrl": "https://www.runninghub.cn/view?filename=13f1c23233ae50f5931b0599ca259b4f7785556cab34c36f16f731d1c6e5a407.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzQyNDExNTE1NjYsInRzIjoxNzczNjM2MzUxNTY2LCJzaWduIjoiZmIyNGZhOTM5OGI3NGU5MmZlZWJkYjEzNGQ3YjA5YjgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8001307955396297"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.cn/openapi/v2/bytedance/dreamactor-v2' \
--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=6c3cad40b41faebf770886a43798285681c9b4690de61aefb520e6f9d7bc22da.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzQyMzI3NzYxNTIsInRzIjoxNzczNjI3OTc2MTUyLCJzaWduIjoiZTFlZmY5OTgxMmZiODhkM2NiNzc3YzNkODEyNjgyNTgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.010155512076242101",
    "videoUrl": "https://www.runninghub.cn/view?filename=13f1c23233ae50f5931b0599ca259b4f7785556cab34c36f16f731d1c6e5a407.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzQyNDExNTE1NjYsInRzIjoxNzczNjM2MzUxNTY2LCJzaWduIjoiZmIyNGZhOTM5OGI3NGU5MmZlZWJkYjEzNGQ3YjA5YjgifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8001307955396297"
}'

返回响应

🟢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-16 12:00:16

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

全能视频S-角色上传-官方稳定版