Skip to main content
POST
Generate a video
Describe the scene and motion in prompt. Defaults are model: "kling-v3-standard" and five seconds. Kling 3 supports 3–15 seconds and optional generate_audio. For multiple shots, send multi_prompt instead of top-level prompt and duration; each shot requires 3–15 seconds and the total must not exceed 15 seconds. Subject references use saved model or outfit assets. The completed result has type: "video". A successful request returns HTTP 202 with a jobs array. Save each id, then get the job until it finishes. Read the completed media from result.url and its reusable ID from result.id. Use an Idempotency-Key when submitting work that may be retried.

Authorizations

Authorization
string
header
required

Create an API key in Studio → account menu → API Keys. Keep it on your server.

Headers

Idempotency-Key
string

Use a unique key for each intended creation. Retry the same method, path and JSON with the same key to replay its response for 24 hours after completion. Conflicting requests and unfinished or uncertain outcomes return 409. An uncertain receipt is never automatically rerun.

Required string length: 1 - 128
Pattern: ^[!-~]+$

Body

application/json
prompt
string
required

Scene and motion direction. Omit when using multi_prompt.

Minimum string length: 1
model
enum<string>
default:kling-v3-standard

Video model. All successful submissions return jobs.

Available options:
kling-v3-pro,
kling-v3-standard
Example:

"kling-v3-standard"

multi_prompt
object[]

Kling 3 shots. Omit prompt and duration when using this array. Each shot requires 3–15 seconds; their total must not exceed 15 seconds. End frames require a single shot.

Required array length: 1 - 5 elements
elements
object[]

Kling 3 subject references. Each asset must be an accessible model or outfit with an HTTP(S) display_image. Model assets are ordered before outfit assets in provider element numbering.

generate_audio
boolean
default:false

Generate audio with Kling 3. Must be false or omitted for kling-2.5.

duration
integer
default:5

Single-shot length in seconds: 5 for kling-2.5; 3–15 for Kling 3. Omit when using multi_prompt.

Required range: 3 <= x <= 15
Example:

5

aspect_ratio
enum<string>

Video output ratio.

Available options:
16:9,
9:16,
1:1
avatar_text
string

Additional subject directions for Kling 3 only.

outfit_text
string

Additional subject directions for Kling 3 only.

Response

Accepted; poll each job.

jobs
object[]
required
Minimum array length: 1