Create Task

This is provided as part of the Kling API from PiAPI.
Create a Kling video with task_type: "video_generation": text-to-video, or image-to-video when image_url is set. Choose the model with version; when version is omitted, 2.6 is used. The same endpoint also creates lip_sync and effects tasks (see the end of this page).

For reference images, videos and audio, use Kling 4.0 / 3.0 omni.

INFO

Versions

Version	Output	Duration (seconds)	Notes
`4.0`	720p / 1080p	3 – 30	latest model; first/last frame and keyframes
`4.0-flash`	720p	3 – 20	faster, lower-cost 4.0; text or a first image
`3.0`	720p / 1080p	3 – 15	multi-shots and optional native audio
`3.0-turbo`	720p / 1080p	3 – 15	faster 3.0; no audio, no multi-shots
`2.6` (default)	std / pro	5 or 10	native audio in pro mode
`2.5`	std / pro	5 or 10
`2.1-master`	pro	5 or 10	always runs and is billed as pro
`2.1`	std / pro	5 or 10	image-to-video only
`1.6`	std / pro	5 or 10
`1.5`	std / pro	5 or 10

Pricing

4.0 and 3.0 (USD per second of output video)

Version	720p (`mode: "std"`)	1080p (`mode: "pro"`)
4.0	0.1667	0.25
4.0-flash	0.10	N/A
3.0, no audio	0.10	0.15
3.0, with audio	0.15	0.20
3.0-turbo	0.13	0.19

For 4.0 / 4.0-flash the task total is rounded to the nearest cent once, after multiplying by duration.

2.6 and earlier (USD per video)

Version	Mode	5s	10s
1.5 / 1.6 / 2.1	std	$0.26	$0.52
1.5 / 1.6 / 2.1	pro	$0.46	$0.92
2.1-master	pro	$0.96	$1.92
2.5 / 2.6	std	$0.20	$0.39
2.5 / 2.6	pro	$0.33	$0.66

2.6 native audio (enable_audio: true) needs mode: "pro" and costs 2× the pro price

enable_audio on versions below 2.6 is currently free and also needs mode: "pro"

Price examples

4.0, 720p, 5s: $0.83 · 10s: $1.67

4.0, 1080p, 10s: 10 * $0.25 = $2.50

4.0-flash, 720p, 10s: 10 * $0.10 = $1.00

3.0, 720p, 10s, no audio: 10 * $0.10 = $1.00

3.0, multi-shots (shot1 2s + shot2 3s), 720p with audio: (2 + 3) * $0.15 = $0.75

3.0-turbo, 1080p, 5s: 5 * $0.19 = $0.95

2.6, pro, 10s with audio: $0.33 * 2 * 2 = $1.32

Feature support

	4.0	4.0-flash	3.0	3.0-turbo	2.6 and earlier
Duration (seconds)	3 – 30	3 – 20	3 – 15	3 – 15	5 or 10
1080p / pro (`mode: "pro"`)	✓	–	✓	✓	✓
First frame `image_url`	✓	✓	✓	✓	✓
Last frame `image_tail_url`	✓	–	✓	✓	pro mode only
`keyframe_urls`	✓	–	–	–	–
`aspect_ratio: "21:9"`	✓	✓	–	–	–
`enable_audio`	–	–	✓	–	pro mode only
`multi_shots` / `prefer_multi_shots`	–	–	✓	–	–
`negative_prompt`	–	–	✓	✓	✓
Cancel task	–	–	✓	✓	✓

Notes

4.0 / 4.0-flash: prompt (up to 2,500 characters) and duration (integer, not clamped or defaulted) are required, including for image-to-video

4.0: first, last and keyframe images together cannot exceed 10. Images must be HTTP(S) URLs; base64 is not supported

4.0 / 4.0-flash accept only the fields marked for them above. enable_audio (even false), negative_prompt, multi-shot fields and other unlisted fields are rejected with error.code: 10003

4.0 / 4.0-flash require config.service_mode: "public"

4.0 / 4.0-flash tasks cannot be cancelled; keep polling Get Task for the final result. Creating the task again is a separate, billable task

3.0 / 3.0-turbo: duration outside 3 – 15 is clamped into that range; when omitted, 3 seconds is used (and billed). Send duration explicitly

3.0 multi_shots: the top-level prompt and duration are ignored, and the task duration (and price) is the sum of the shots. Each shot needs a prompt and 1 – 14 seconds (3 when omitted); at most 6 shots and 15 seconds in total. Otherwise the request is rejected with error.code: 10003

enable_audio: true combined with version: "3.0-turbo" is rejected with a validation error

2.6 and earlier: duration other than 5 or 10 becomes 5; aspect_ratio other than 16:9, 9:16 or 1:1 becomes 16:9

2.1: text-to-video is not available; send image_url

Response

output.video is the video URL for every version (an empty string until the task completes). New integrations should read only this field.

3.0, 3.0-turbo, 4.0 and 4.0-flash return only output.video

2.6 and earlier, lip_sync and effects also return the legacy fields video_url, type, status and works, kept for existing integrations

Poll Get Task or set config.webhook_config; both carry the same output.

Other task types on this endpoint

lip_sync: set origin_task_id to a completed Kling video task and local_dubbing_url (required). Text-to-speech via tts_text is currently not available. See Lipsync examples

effects: set effect. See Kling Effects

application/json

Bodyapplication/json

Examples

kling 4.0 / 3.0kling 2.6 and earlier

{
    "code": 200,
    "data": {
        "task_id": "40680c72-279e-42c2-a4c0-e96e71865f04",
        "model": "kling",
        "task_type": "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,
            "mode": "std",
            "multi_shots": [
                {
                    "duration": 3,
                    "prompt": "A dog running near the sea"
                },
                {
                    "duration": 2,
                    "prompt": "The dog stop before a cat on beach"
                }
            ],
            "prefer_multi_shots": true,
            "version": "3.0"
        },
        "output": {
            "video": ""
        },
        "meta": {
            "created_at": "2026-02-13T04:17:29.108326563Z",
            "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"
}

Create Task

Versions

Pricing

Feature support

Notes

Response

Other task types on this endpoint

Request

Request Code Samples

Responses

Create Task

Versions#

Pricing#

Feature support#

Notes#

Response#

Other task types on this endpoint#

Request

Request Code Samples

Responses

Versions

Pricing

Feature support

Notes

Response

Other task types on this endpoint