可灵 Kling 动作控制 (Motion Control)

通过上传参考图像和参考视频，让图像中的人物执行视频中的动作。

1. 创建任务

接口地址： POST /kling/v1/videos/motion-control

功能描述： 提交一个动作控制视频生成任务。视频生成是异步过程，提交成功后会返回 task_id，之后需要通过查询接口获取结果。

认证方式： Bearer Token

Authorization: Bearer YOUR_API_TOKEN

请求参数 (Body)

字段	类型	必填	默认值	描述
prompt	string	可选	空	文本提示词，可包含正向描述和负向描述。可通过提示词为画面增加元素、实现运镜效果等。不能超过2500个字符。
image_url	string	必须	无	参考图像，生成视频中的人物、背景等元素均以参考图为准。支持传入图片Base64编码或图片URL。图片格式支持 .jpg / .jpeg / .png。图片大小不超过10MB。 注意： 如果使用 Base64，请直接传递编码后的字符串，不要包含 data:image/png;base64, 等前缀。
video_url	string	必须	无	参考视频的获取链接。生成视频中的人物动作与参考视频一致。支持 .mp4/.mov，大小不超过100MB，时长不短于3秒。
keep_original_sound	string	可选	yes	是否保留视频原声。枚举值：yes, no。
character_orientation	string	必须	无	生成视频中人物的朝向。枚举值：image (与图片一致), video (与视频一致)。
mode	string	必须	无	生成视频的模式。枚举值：std (标准模式), pro (专家模式)。
callback_url	string	可选	无	任务结果回调通知地址。
external_task_id	string	可选	无	用户自定义任务ID，单用户下需保证唯一性。

响应参数

字段	类型	描述
code	integer	错误码 (0 表示成功)
message	string	错误信息
request_id	string	请求ID
data	object	数据对象
data.task_id	string	任务ID
data.task_status	string	任务状态：submitted (已提交), processing (处理中), succeed (成功), failed (失败)

---

2. 查询任务 (单个)

接口地址： GET /v1/video/generations/:task_id

功能描述： 根据任务 ID 查询视频生成任务的状态和结果。

认证方式： Bearer Token

Authorization: Bearer YOUR_API_TOKEN

请求路径参数

字段	类型	必填	描述
task_id	string	必须	任务 ID，由创建任务接口返回

响应参数

字段	类型	描述
code	integer	错误码 (0 表示成功)
message	string	错误信息
request_id	string	请求ID，用于跟踪请求、排查问题
data	object	数据对象
data.task_id	string	任务ID
data.task_status	string	任务状态：submitted (已提交), processing (处理中), succeed (成功), failed (失败)
data.task_status_msg	string	任务状态信息，当任务失败时展示失败原因
data.task_info	object	任务创建时的参数信息
data.task_info.external_task_id	string	客户自定义任务ID
data.task_result	object	任务结果（仅成功时返回）
data.task_result.videos	array	生成的视频列表
data.task_result.videos[].id	string	生成的视频ID，全局唯一
data.task_result.videos[].url	string	生成视频的URL（注意：视频会在30天后被清理，请及时转存）
data.task_result.videos[].duration	string	视频总时长，单位秒
data.created_at	integer	任务创建时间，Unix时间戳（毫秒）
data.updated_at	integer	任务更新时间，Unix时间戳（毫秒）

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_123456",
  "data": {
    "task_id": "task_123456",
    "task_status": "succeed",
    "task_status_msg": "success",
    "task_info": {
      "external_task_id": "custom_id_123"
    },
    "task_result": {
      "videos": [
        {
          "id": "vid_123",
          "url": "https://example.com/video.mp4",
          "duration": "5"
        }
      ]
    },
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}