Skip to main content
POST
Submit Kling AI task

Submit task

prompt, type, quality_mode, and duration are required. image-to-video requires exactly one URL in image_urls; text-to-video must omit it.
kling-v2-1-master is the valid Master key; kling-v2-master is not accepted. aspect_ratio and sound apply only to kling-v2-6. For image-to-video, image_tail, masks, and camera_control are mutually exclusive.

Authorizations

Authorization
string
header
required

Wizzx API key. This is not a JWT.

Body

application/json

image-to-video requires exactly one image_urls item; text-to-video must omit image_urls. image_tail, masks, and camera_control are mutually exclusive for image-to-video. aspect_ratio and sound are only valid for kling-v2-6.

type
enum<string>
required
Available options:
text-to-video
model_name
enum<string>
default:kling-v1
required
prompt
string
required

Required prompt. The gateway enforces a 2500-byte UTF-8 limit.

Minimum string length: 1
quality_mode
enum<string>
required
Available options:
std,
pro
duration
enum<integer>
required
Available options:
5,
10
image_urls
string<uri>[]
Maximum array length: 1

Publicly reachable HTTP(S) URL.

Pattern: ^https?://
image_tail
string
negative_prompt
string

Optional negative prompt. The gateway enforces a 2500-byte UTF-8 limit.

cfg_scale
number

V1.x only. Explicit 0 is currently normalized to 0.5; omit for V2.x.

Required range: 0 <= x <= 1
aspect_ratio
enum<string>

kling-v2-6 only; defaults to 16:9 for that model.

Available options:
16:9,
9:16,
1:1
sound
enum<string>

kling-v2-6 only; defaults to off.

Available options:
on,
off
static_mask
string
dynamic_masks
object[]
Maximum array length: 6
camera_control
object
callback_url
string<uri>
external_task_id
string

Response

Task accepted

code
enum<integer>
required
Available options:
0
message
string
required
Example:

"success"

data
object
required
request_id
string<uuid>
required