Create Task

POST

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

This is provided as part of the Kling API from PiAPI.
This service allows you access to APIs for the most advanced video generation model - Kuaishou's KlingAI.
You can create Text-to-video, Image-to-video, Extend video, Lipsync task and Effects task through this endpoint.

INFO

Text-to-video vs Image-to-video

If the parameter image_url is left null then the task would be a text-to-video task; if filled out, then the task would be an image-to-video task.

About version 1.5 1.6 2.0 2.1 and 2.1-master

The V1.5/1.6 model through the API currently has all the features and constraints as per klingai.com
pricing for 2.1 is the same as 1.6
pricing for 2.0/2.1-master: 2.0-pro-5s: USD0.96/generation, 2.0-pro-10s: USD1.92/generation

Video Lengths

For the video lengths (5s vs 10s) of the API-generated-videos for each model (1.0 1.5 1.6 2.0 2.1 and 2.1-master) and modes (std vs pro) combination, please refer to what is allowed on klingai.com; the API currently aligns with the website.

Request

Header Params

Body Params application/json

Example

{
    "model": "kling",
    "task_type": "video_generation",
    "input": {
        "prompt": "White egrets fly over the vast paddy fields",
        "negative_prompt": "",
        "cfg_scale": 0.5,
        "duration": 5,
        "aspect_ratio": "1:1",
        "camera_control": {
            "type": "simple",
            "config": {
                "horizontal": 0,
                "vertical": 0,
                "pan": -10,
                "tilt": 0,
                "roll": 0,
                "zoom": 0
            }
        },
        "mode": "std"
    },
    "config": {
        "service_mode": "",
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}

Request 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": "video_generation",
    "input": {
        "prompt": "White egrets fly over the vast paddy fields",
        "negative_prompt": "",
        "cfg_scale": 0.5,
        "duration": 5,
        "aspect_ratio": "1:1",
        "camera_control": {
            "type": "simple",
            "config": {
                "horizontal": 0,
                "vertical": 0,
                "pan": -10,
                "tilt": 0,
                "roll": 0,
                "zoom": 0
            }
        },
        "mode": "std"
    },
    "config": {
        "service_mode": "",
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 200,
    "data": {
        "task_id": "6e269e8c-2091-46c4-b4a5-40a4704a766a",
        "model": "kling",
        "task_type": "video_generation",
        "status": "",// pending/processing/failed/completed
        "config": {
            "service_mode": "public",
            "webhook_config": {
                "endpoint": "",
                "secret": ""
            }
        },
        "input": {},
        "output": {
            "video_url": ""
        },
        "meta": {},
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}

Modified at 2025-06-13 08:20:38

Get Task

Kling Virtual Try-On