Skip to main content
POST

Authorizations

Authorization
string
header
required

Bearer YOUR_API_KEY. Manage keys in API Keys.

Body

application/json
model
string
required

Also accepts the legacy alias kling/kling-v3-omni.

Allowed value: "kling-v3-omni"
prompt
string

Required for generation; optional for edits.

Required string length: 1 - 2500
resolution
enum<string>
default:720P

Output resolution.

Available options:
720P,
1080P,
4K
duration
integer
default:4

Output seconds. Edits follow the source.

Required range: 3 <= x <= 15
aspect_ratio
enum<string>
default:16:9

Output aspect ratio.

Available options:
16:9,
9:16,
1:1
reference_images
object[]

References or keyframes.

Maximum array length: 7
reference_videos
object[]

Reference videos or an edit source.

Maximum array length: 1
generate_audio
boolean
default:false

With input video, omit or set false.

extra_params
object

Response

Task accepted.

task_id
string
required

Task ID to poll.

model
string
required

Echoes the supplied model ID or legacy alias.

created_at
string<date-time>
required

Task creation time (UTC).

request_id
string
required

Request ID.