跳转到主要内容
POST
提交 Kling 2.6 动作控制任务
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
将参考视频中的动作迁移到角色图片上,实现精确的动作控制。把静态图片与动作参考视频结合,创建动态的角色动画,并通过文本提示词控制场景细节。

模型

  • kling-2.6-motion-control - 将视频中的动作迁移到角色图片上

功能

  • 动作迁移:将参考视频中真实人物的动作、手势和表情迁移到角色图片上
  • 角色动画:用动态的动作模式让静态角色动起来
  • 角色朝向控制:可选择与图片朝向一致(输出最长 10 秒)或与视频朝向一致(输出最长 30 秒)
  • 场景控制:通过可选的文本提示词控制场景细节和环境
  • 灵活分辨率:可选择 720p(标准)或 1080p(高画质)输出

必填参数

  • image_urls:单张角色图片,需显示主体的头部、肩部和躯干
  • video_urls:用于动作迁移的单个参考视频(3-30 秒)
  • character_orientation:
    • "image" - 与照片中人物的朝向一致(输出最长 10 秒)
    • "video" - 与参考视频中的角色朝向保持一致(输出最长 30 秒)
  • mode:输出分辨率("720p" 或 "1080p")

可选参数

  • prompt:期望输出场景的文本描述(最多 2,500 个字符)

工作流程 ID

现有 ID 仍可继续使用。新接入可以选择专用的工作流程:

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key:

进入 仪表盘 → API 密钥(API Key 管理页面)获取 API Key

在请求头中添加:

请求体

application/json
model
string
必填
示例:

"kling-2.6-motion-control"

callback_url
string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

input
object

动作控制生成参数

响应

200 - application/json

任务提交成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填