动作控制

POST

/kling/motion-control/kling-3.0

最后修改时间：2026-11-05 05:39:54

使用一张外观/人物参考图和一段动作参考视频生成视频。contents 必须包含 image 和 video；prompt 可选。
character_orientation=image 时参考视频最长 10 秒；character_orientation=video 时最长 30 秒。参考视频最短 3 秒。
官方完整文档：https://www.klingai.com/document-api/api/video/motion-control

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "contents": [
        {
            "type": "prompt",
            "text": "The girl is wearing a loose gray T-shirt and denim shorts"
        },
        {
            "type": "image",
            "url": "https://example.com/character.png"
        },
        {
            "type": "video",
            "url": "https://example.com/dance.mp4"
        }
    ],
    "settings": {
        "character_orientation": "video",
        "audio": "original",
        "resolution": "1080p"
    },
    "options": {
        "callback_url": "https://example.com/callback",
        "external_task_id": "motion_001",
        "watermark_info": {
            "enabled": false
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/kling/motion-control/kling-3.0' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "type": "prompt",
            "text": "The girl is wearing a loose gray T-shirt and denim shorts"
        },
        {
            "type": "image",
            "url": "https://example.com/character.png"
        },
        {
            "type": "video",
            "url": "https://example.com/dance.mp4"
        }
    ],
    "settings": {
        "character_orientation": "video",
        "audio": "original",
        "resolution": "1080p"
    },
    "options": {
        "callback_url": "https://example.com/callback",
        "external_task_id": "motion_001",
        "watermark_info": {
            "enabled": false
        }
    }
}'

返回响应

🟢200

application/json

任务提交成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "request_id": "req_1234567890abcdef",
    "data": {
        "id": "task_893605946402811985",
        "status": "submitted",
        "create_time": 1781080778802,
        "update_time": 1781080794151,
        "external_id": "my_custom_001"
    }
}

🟠400

🟠401

修改于 2026-11-05 05:39:54

删除自定义音色

Blend提交参数