Kling 3 - PiAPI

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

Pricing
According to the resolution and duration of generated video

A price reduction is planned for this API.

Resolution	Enable audio	Price(USD) per second
720	false	0.15
720	true	0.2
1080	false	0.2
1080	true	0.3

Price example

generate a 10 second video of 720p without audio will cost: 10 * $0.15 = $1.5

generate a multi-shots video, shot1 2s, shot2 3s, 720p with audio will cost: (2 + 3) * $0.2 = $1

Note

If multi shots used, param prompt and duration will be ignored

Maximum 6 multi shots, total duration should not exceed 15 seconds

if ref images provided, use @image_i in prompt to reference. i starts at 1, so use @image_1 for the first image in images list, @image_2 for the second image, etc.

ref images can be used multiple times in prompt, for example: use @image_1 as start frame, a woman @image_2 is introducing herself, and use @image_1 as end frame

Request

Header Params

Body Params application/json

Examples

text to videomulti shotsimage to video

{
    "model": "kling",
    "task_type": "omni_video_generation",
    "input": {
        "prompt": "Close-up, static camera, a woman in swim suit near the sea is introducing herself.",
        "version": "3.0",
        "resolution": "720p",
        "duration": 3,
        "aspect_ratio": "16:9",
        "enable_audio": false
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/5468eca8-1cad-4dd3-9799-b6fbd9770fda",
            "secret": ""
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "code": 200,
    "data": {
        "task_id": "5a9b4d8f-6f1c-460d-b295-ab1d663f9b90",
        "model": "kling",
        "task_type": "omni_video_generation",
        "status": "pending",
        "config": {
            "service_mode": "public",
            "webhook_config": {
                "endpoint": "https://webhook.site/5468eca8-1cad-4dd3-9799-b6fbd9770fda",
                "secret": ""
            }
        },
        "input": {
            "aspect_ratio": "16:9",
            "enable_audio": true,
            "multi_shots": [
                {
                    "duration": 2,
                    "prompt": "a dog stands near sea"
                },
                {
                    "duration": 3,
                    "prompt": "the dog turns around and walks on beach"
                }
            ],
            "resolution": "720p",
            "version": "3.0"
        },
        "output": {
            "video": ""
        },
        "meta": {
            "created_at": "2026-02-07T02:31:17.998381738Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "point",
                "frozen": 10000000,
                "consume": 0
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": null,
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}