Skip to main content
POST
Create a text-to-video task

Authorizations

Authorization
string
header
required

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

Body

application/json
prompt
string
required

Positive text prompt. Maximum 2500 characters.

Maximum string length: 2500
Example:

"A cat walking through a sunflower field at golden sunset"

model_name
enum<string>

Model name

Available options:
kling-v3
Example:

"kling-v3"

negative_prompt
string

Negative text prompt. Maximum 2500 characters.

Maximum string length: 2500
mode
enum<string>
default:std

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

Available options:
std,
pro
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"

aspect_ratio
enum<string>
default:16:9

Aspect ratio of the generated video (width:height).

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

"16:9"

cfg_scale
number
default:0.5

Prompt adherence (0-1). Higher values give the model less freedom. Not supported by kling-v2.x models.

Required range: 0 <= x <= 1
multi_shot
boolean
default:false

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

shot_type
enum<string>

Storyboard mode. Required when multi_shot is true.

Available options:
customize,
intelligence
multi_prompt
object[]

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

sound
enum<string>
default:off

Whether to generate sound effects at the same time. Supported on V2.6 and later.

Available options:
on,
off
camera_control
object

Camera movement parameters.

watermark_info
object
callback_url
string

Callback URL for task status notifications

external_task_id
string

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

Response

Task created

id
string
Example:

"860260753860210752"

task_id
string
Example:

"860260753860210752"

object
string
Example:

"video"

model
string
Example:

"kling-v3"

status
string
progress
integer
Example:

0

created_at
integer
Example:

1773130665