Video Generation Endpoint - Legacy Kling API

Request

Header Params

X-API-key

string

required

Your API KEY used for request authorization

Body Params application/json

negative_prompt

string

optional

negative prompt of your video, can be empty

prompt

string

required

prompt of your video

creativity

number

optional

a number between 0 to 1, the lower the more creative

duration

number

optional

can only be 5 or 10, defaults to 5

aspect_ratio

string

required

can only be 16:9,9:16,1:1

professional_mode

boolean

optional

PAID KLING PLAN NEEDED. Default to false, visit Kling AI official product to get the definition of professional mode

image_url

string

optional

initial frame of the video, DO NOT pass this param if you just want text-to-video

tail_image_url

string

optional

PAID KLING PLAN NEEDED. End frame of the video, DO NOT pass this param if you just want text-to-video

camera

object

optional

camera control of the video, effective in text-to-image ONLY. TRY it on Kling official website before using this param

type

string

optional

horizontal

number

optional

vertical

number

optional

zoom

number

optional

tilt

number

optional

pan

number

optional

roll

number

optional

Example

{
  "negative_prompt": "string",
  "prompt": "string",
  "creativity": 0,
  "duration": 0,
  "aspect_ratio": "string",
  "professional_mode": true,
  "image_url": "string",
  "tail_image_url": "string",
  "camera": {
    "type": "string",
    "horizontal": 0,
    "vertical": 0,
    "zoom": 0,
    "tilt": 0,
    "pan": 0,
    "roll": 0
  }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.piapi.ai/api/kling/v1/video' \
--header 'X-API-key;' \
--header 'Content-Type: application/json' \
--data-raw ''

Responses

🟢200OK

application/json

OK-Successful Response

Body

code

integer

optional

data

object

optional

task_id

string

optional

message

string

optional

Example

{
  "code": 0,
  "data": {
    "task_id": "string"
  },
  "message": "string"
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error