Skip to main content
POST
Create a video task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model_name
enum<string>

Model name

Available options:
kling-v3-omni
Example:

"kling-v3-omni"

prompt
string

Text prompt. Supports positive and negative descriptions. Use <<<element_1>>>、<<<image_1>>>、<<<video_1>>> to reference elements/images/videos. Required when multi_shot is false.

Maximum string length: 2500
Example:

"A cat walking gracefully through a sunlit garden"

mode
enum<string>
default:pro

Video generation mode. std: standard mode (better value). pro: professional mode (higher quality).

Available options:
std,
pro
Example:

"pro"

aspect_ratio
enum<string>

Aspect ratio of the generated video (width:height). Required when no first-frame reference or video editing is used.

Available options:
16:9,
9:16,
1:1
Example:

"16:9"

duration
enum<string>
default:5

Video duration in seconds, 3–15.

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
Example:

"5"

multi_shot
boolean
default:false

Whether to generate a multi-shot video. When true, the prompt parameter is ignored and multi_prompt must be used.

shot_type
enum<string>

Storyboard mode. Required when multi_shot is true.

Available options:
customize
multi_prompt
object[]

Storyboard shots (1–6). Required when multi_shot is true and shot_type is customize .

image_list
object[]

Reference image list. Supports first/last frame, scene, and style references. Format .jpg/.jpeg/.png, ≤10MB, minimum 300px, aspect ratio 1:2.5–2.5:1。

element_list
object[]

Reference element list, based on element IDs from the Kling element library.

video_list
object[]

Reference video list. MP4/MOV only, ≥3 seconds, 720px–2160px, 24–60fps, ≤200MB.

sound
enum<string>
default:off

Whether to generate sound effects together with the video. Must be off when a reference video is provided.

Available options:
on,
off
watermark_info
object

Watermark configuration

callback_url
string

Callback URL for task status changes

external_task_id
string

Custom task ID. Must be unique within the same account.

Response

Task created successfully

id
string

Task ID

Example:

"860260753860210752"

task_id
string

Task ID

Example:

"860260753860210752"

object
string
Example:

"video"

model
string
Example:

"kling-v3-omni"

status
string

Task status

progress
integer

Progress percentage

Example:

0

created_at
integer

Unix timestamp

Example:

1773130665