动作控制生视频

POST

/kling/v1/videos/motion-control

模型 model_name 为 kling-v2-6。

让一张图里的角色，照着参考视频里的动作动起来。提交后返回任务 id。

常用参数：image_url 角色图，video_url 动作参考视频，prompt 提示词，character_orientation 朝向（如 image），keep_original_sound 是否保留原声（yes/no），mode 画质。

结果视频是临时链接，约 10 分钟内有效，请尽快下载保存；有些网络下载时需要带上 User-Agent 请求头。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

Body 参数application/json必填

示例

{
    "model_name": "kling-v2-6",
    "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
    "prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
    "video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
    "keep_original_sound": "yes",
    "character_orientation": "image",
    "mode": "pro",
    "callback_url": "",
    "external_task_id": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/kling/v1/videos/motion-control' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "kling-v2-6",
    "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
    "prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
    "video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
    "keep_original_sound": "yes",
    "character_orientation": "image",
    "mode": "pro",
    "callback_url": "",
    "external_task_id": ""
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "908455155350638678",
    "task_id": "908455155350638678",
    "object": "video",
    "model": "kling-v1",
    "status": "",
    "progress": 0,
    "created_at": 1784621106
}

修改于 2026-07-21 08:57:03

多图参考生视频

图生视频（含首尾帧）