Kling Motion Control

POST

https://api.piapi.ai/api/v1/task

This is the api for Kling's Motion Control video generation API.

Pricing
According to the duration of input motion video(preset or uploaded)

std: $0.065 per second

pro: $0.104 per second

Note

Currently only version 2.6 supports motion control

One of video_url and preset_motion must be provided as motion reference

Request

Header Params

Body Params application/json

Example

{
    "model": "kling",
    "task_type": "motion_control",
    "input": {
        "image_url": "https://example.com/kling/digital/image/Isabella.png",
        "video_url": "",
        "preset_motion": "Heart Gesture Dance",
        "motion_direction": "video",
        "keep_original_sound": true,
        "mode": "std",
        "version": "2.6"
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/ce576103-6cd3-43a6-8aac-c8f0dc13adc0",
            "secret": ""
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "kling",
    "task_type": "motion_control",
    "input": {
        "image_url": "https://example.com/kling/digital/image/Isabella.png",
        "video_url": "",
        "preset_motion": "Heart Gesture Dance",
        "motion_direction": "video",
        "keep_original_sound": true,
        "mode": "std",
        "version": "2.6"
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/ce576103-6cd3-43a6-8aac-c8f0dc13adc0",
            "secret": ""
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 200,
    "data": {
        "task_id": "820b72ec-5235-4315-a3ea-cf95057787b8",
        "model": "kling",
        "task_type": "motion_control",
        "status": "pending",
        "config": {
            "service_mode": "public",
            "webhook_config": {
                "endpoint": "https://webhook.site/ce576103-6cd3-43a6-8aac-c8f0dc13adc0",
                "secret": ""
            }
        },
        "input": {
            "image_url": "https://example.com/kling/digital/image/Isabella.png",
            "keep_original_sound": true,
            "mode": "std",
            "motion_direction": "video",
            "preset_motion": "Heart Gesture Dance",
            "version": "2.6",
            "video_url": ""
        },
        "output": {
            "type": "",
            "status": 0,
            "works": null
        },
        "meta": {
            "created_at": "2026-01-06T13:11:22.513893572Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "point",
                "frozen": 0,
                "consume": 0
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": null,
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}

Modified at 2026-01-07 10:48:03

Kling Avatar

Kling Turbo