APIMODELSAPIMODELS
API 文档

apimodels.app

获取 API 密钥模型市场

Kling 动作控制 API 参数文档(Kling 3.0 与 2.6)

快手 Kling 的 AI 动作控制(动作迁移)。把参考视频里的舞蹈或动作迁移到一张人物图片上,生成这个人物做出该动作的视频。两个输入缺一不可:一张角色图 + 一段动作视频。两个版本同一个接口:Kling 3.0(kling-3.0-motion-control)720p $0.10/s、1080p $0.15/s;Kling 2.6(kling-motion-control)720p $0.06/s、1080p $0.10/s。按参考视频秒数计费,最长 30 秒。异步接口:创建任务后轮询同一端点取结果。

模型页:Kling AI Motion Control API —— 价格、规格与在线体验

两个输入分别放哪

  • input_urls —— 人物照片,全身照效果最佳(PNG/JPG)。这是「谁在动」。
  • video_urls —— 舞蹈或动作参考视频(MP4)。这是「怎么动」。

两个字段都是数组,且都必填。把动作视频放进 input_urls 或把人像放进 video_urls,任务不会按你预期的方向生成。

可用模型

模型API时长价格
Kling 3.0 Motion Controlkling-3.0-motion-control最长 30 秒$0.10/s+ (720p $0.10/s · 1080p $0.15/s)
Kling 2.6 Motion Controlkling-motion-control最长 30 秒$0.06/s+ (720p $0.06/s · 1080p $0.10/s)
DreamActor V2dreamactor-v2最长 30 秒$0.06/s

DreamActor V2 同样是「图像 + 参考视频 → 角色动作迁移」,详情见 /models/dreamactor-v2。本页参数契约对应 kling-3.0-motion-control 与 kling-motion-control(两者字段完全相同)。

创建任务

POST /api/v1/video/generations —— 异步:创建后轮询同一个端点取结果。

# Step 1: Create motion control task
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-motion-control",
    "input_urls": ["https://example.com/character.png"],
    "video_urls": ["https://example.com/dance-motion.mp4"],
    "mode": "720p",
    "character_orientation": "video"
  }'

# Step 2: Poll status
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求参数

字段必填类型说明
model是string"kling-3.0-motion-control"(Kling 3.0,也收 kling-v3-motion-control)或 "kling-motion-control"(Kling 2.6,也收 kling-2.6-motion-control)
input_urls是array角色参考图片 URL(PNG/JPG)
video_urls是array动作参考视频 URL(MP4)
mode否string"720p"(默认)或 "1080p"
character_orientation否string"image"(默认)跟随人物图片方向,"video" 跟随动作视频方向
callback_url否string任务完成后的回调 URL

character_orientation 怎么选

取值人物朝向跟随
video动作参考视频的方向
image(默认)人物图片本身的方向

计费与注意事项

  • 按参考视频的秒数计费(向上取整,最长 30 秒):Kling 3.0 720p $0.10/s、1080p $0.15/s;Kling 2.6 720p $0.06/s、1080p $0.10/s。
  • input_urls 放人物照片,全身照效果最佳。
  • video_urls 放舞蹈或动作参考视频。
  • 任务状态:pending / processing / completed / failed。completed 时读 data.resultUrls[0],failed 时读 data.failMsg。
  • 建议每 5-10 秒轮询一次;生产环境用 callback_url 更省事。
  • 生成的视频文件保存 30 天,请及时下载或转存。
  • Kling 还有专属接口,文生视频、图生视频等更多高级功能见 Kling 视频 API 文档。

相关

模型页 / 在线试用DreamActor V2 模型页Kling 视频 API 文档视频 API 总览

常见问题

怎么让照片里的人物做出视频里的动作?

向 apimodels.app 的 POST /api/v1/video/generations 发请求，model 填 "kling-3.0-motion-control"(Kling 2.6 用 "kling-motion-control")，人物照片放 input_urls、舞蹈或动作视频放 video_urls；再用 GET /api/v1/video/generations?task_id= 轮询，state 变成 completed 后取 data.resultUrls[0]。两个字段都是数组，且都必填。

Kling 动作控制怎么计费?

在 apimodels.app 上按参考视频的秒数计费,向上取整、最多 30 秒。Kling 3.0:720p $0.10/s、1080p $0.15/s,10 秒 720p 是 $1.00。Kling 2.6:$0.06/s、$0.10/s,同样一段是 $0.60。失败不扣费。

怎么输出 1080p 而不是 720p?

在创建请求里把 mode 设为 "1080p"，默认值是 "720p"。价格跟着分辨率走:Kling 3.0 720p $0.10/s、1080p $0.15/s;Kling 2.6 $0.06/s、$0.10/s。

角色参考图用什么样的最好?

全身照效果最佳。图片以公开的 PNG/JPG 地址放进 input_urls，动作来源仍然放 video_urls，是 MP4 地址。

character_orientation 参数是干什么的?

它决定生成出来的人物朝向跟谁："image"(默认)跟随你上传的人物图片本身的方向,"video" 跟随动作参考视频的方向。

除了 Kling,还有别的动作迁移模型吗?

有。DreamActor V2（rh-dreamactor/dreamactor-v2）同样是「图像 + 参考视频 → 角色动作迁移」，$0.06/s，最长 30 秒。两者走同一个视频端点、同一把 API Key。