Skip to main content
POST

Headers

Authorization
string
required

Bearer API key, e.g. Bearer sk-....

Example:

"Bearer sk-..."

Body

application/json

Kling create-video body.

model
string
required

Model alias (case-insensitive). Generation: kling-1.0 … kling-3.0-omni, kling-o1. Specialty: kling-identify-face, kling-avatar-720p, kling-avatar-1080p.

Example:

"kling-2.5"

prompt
string

Text prompt (required for most scenarios).

seconds
string

Duration in seconds as string, e.g. "5", "10". Highest priority for duration.

Example:

"5"

duration

Duration in seconds; ignored if top-level seconds is set.

size
string

Size shortcut, e.g. 720x1280, 720P, 1080P. Can imply resolution + aspect ratio.

Example:

"720x1280"

image
string

Single reference image URL.

images
string[]

Multi reference image URLs (max 3). Prefer images for Omni referenced billing.

Maximum array length: 3
input_reference
string

Reference image URL (similar to image).

mode
string

e.g. pro for motion-control Pro tier.

Example:

"pro"

content
object[]

OpenAI-style multimodal content. Text is taken from type=text parts.

metadata
object

Kling extended options.

Response

200 - application/json

Task accepted

id
string
task_id
string
object
string
Example:

"video"

model
string

Concrete billing tier name.

status
string

queued / pending / processing / in_progress / completed / failed / cancelled

progress
integer
created_at
integer
completed_at
integer
seconds
string
size
string
video_url
string
error
object