Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <YOUR_API_KEY> in the request header. Go to the API Keys management page to create and manage API Keys.

Body

application/json
​
model
string
required

Fixed value kling/kling-v3-omni.

​
prompt
string

The prompt, which may contain both positive and negative descriptions. Up to 2500 characters.

The Omni model supports referencing subjects, images, and videos in the prompt using the <<<>>> syntax, e.g. <<<element_1>>>, <<<image_1>>>, <<<video_1>>>.

Required when:

  • extra_params.multi_shot=false, or extra_params.multi_shot=true with extra_params.shot_type=intelligence.

When extra_params.multi_shot=true and extra_params.shot_type=customize, this field is ignored — per-shot prompts are provided via extra_params.multi_prompt.

Example:

"A slow pan across a misty mountain valley at sunrise, cinematic"

​
resolution
enum<string>
default:720P

Output resolution. Defaults to 720P.

Available options:
720P,
1080P
​
aspect_ratio
enum<string>
default:16:9

Output aspect ratio. Defaults to 16:9.

Available options:
16:9,
9:16,
1:1
​
duration
enum<integer>
default:5

Video duration in seconds. Defaults to 5. Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

When using video editing (reference_videos[].reference_type=edit_source), this parameter is ignored — the output duration matches the input video and is billed based on the input video duration, rounded to the nearest second.

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
​
generate_audio
boolean
default:false

Whether to generate audio. Defaults to false.

​
reference_images
object[]

Supports asset images, first_frame and last_frame. Up to 7 asset images without video, or 0-4 asset images with a video. This API does not expose first_frame / last_frame combined with video.

Image requirements:

  • Formats: jpg / jpeg / png;
  • Size ≤ 10 MB;
  • Dimensions ≥ 300px, aspect ratio between 1:2.5 and 2.5:1.
Maximum array length: 7
​
reference_videos
object[]

At most 1 video. asset (default) supplies a reference; edit_source edits the original video. Both modes support 0-4 accompanying images with reference_type=asset.

keep_original_sound controls the original track of this material; omission follows the model default. generate_audio has no effect when a video is supplied.

Video requirements:

  • Formats: MP4 / MOV;
  • Size ≤ 200 MB;
  • Duration ≥ 3s (upper bound depends on the model version);
  • Dimensions: 720px – 2160px inclusive;
  • Frame rate: 24 – 60 fps (output is always 24 fps);
  • Publicly accessible URL only; base64 is not supported.
Maximum array length: 1
​
extra_params
object

Kling's official extension parameters. All optional.

Response

Submitted successfully (asynchronous mode)

​
task_id
string

Unique task ID, used for subsequent polling

Example:

"task_2042864638838083584"

​
model
string

The model ID used for this task

Example:

"kling/kling-v3-omni"

​
created_at
string

Task creation time (ISO 8601)

Example:

"2026-04-13T07:17:39.146Z"

​
request_id
string

Unique request ID

Example:

"291a4117-9df8-4349-aee1-bdf8ffcacb9a"