Skip to main content
POST
Kling V3 Omni T2V

Authorizations

Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Kling V3 text-to-video request aligned with official settings: audio native|off, resolution 720p|1080p|4k, multi_shot, aspect_ratio, duration. No separate negative_prompt.

prompt
string
required

Video generation prompt. May include both positive and negative descriptions in the same text (no separate negative_prompt field). For custom multi-shot storyboards, use shot n, m, words; shot n, m, words; where n is the shot index (1-6), m is shot duration in seconds (each >= 1s; sum of all shot durations must equal total duration), and words is the per-shot prompt (max 512 characters). Max length 3072 (recommended <= 2500).

Required string length: 1 - 3072
Example:

"shot 1, 2, A lone cyclist rides through a neon-lit city street after rain; shot 2, 3, Close-up of raindrops on the helmet as neon reflections glide by;"

audio
enum<string>
default:off

Whether to generate audio for the video. Official settings.audio: native | off.

Available options:
native,
off
Example:

"off"

multi_shot
boolean
default:true

When true, the model automatically plans multi-shot transitions. When false, generates a single continuous shot.

Example:

true

resolution
enum<string>
default:720p

Output video resolution.

Available options:
720p,
1080p,
4k
Example:

"1080p"

aspect_ratio
enum<string>
default:16:9

Video aspect ratio.

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

"16:9"

duration
enum<integer>
default:5

Video duration in seconds. Public API accepts integer values.

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

6

Response

Task submitted successfully

code
integer
required

Response code, 0 indicates success

Example:

0

message
string
required

Response message

Example:

"success"

data
object
required

Detailed data about the submitted asynchronous task.