Skip to main content
POST
Submit Kling v3 task

Submit task

prompt and type are required. image-to-video takes 1 public HTTP(S) image URL (first frame) or 2 (first and last frame); text-to-video must omit image_urls. resolution is 720p (default) or 1080p, and duration is 3–15 seconds (default 5).
The gateway charges per second: 720p = 130 (194 with audio), 1080p = 173 (259 with audio) credits. Read /pricing for the current amount.

Authorizations

Authorization
string
header
required

Wizzx API key. This is not a JWT.

Body

application/json

text-to-video must omit image_urls; image-to-video takes 1 image (first frame) or 2 images (first and last frame). Billed per second by resolution and generate_audio.

type
enum<string>
required
Available options:
text-to-video
prompt
string
required

Required prompt, at most 2500 Unicode characters.

Required string length: 1 - 2500
image_urls
string<uri>[]
Maximum array length: 2

Publicly reachable HTTP(S) URL.

Pattern: ^https?://
resolution
enum<string>
default:720p

720p (standard) or 1080p (professional). 4K is not offered.

Available options:
720p,
1080p
duration
integer
default:5
Required range: 3 <= x <= 15
aspect_ratio
enum<string>

Defaults to 16:9. In image-to-video the first frame's ratio may take precedence.

Available options:
16:9,
9:16,
1:1
generate_audio
boolean
default:false

Generate native audio. Audio selects a higher per-second rate.

negative_prompt
string
Maximum string length: 2500

Response

Task accepted

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

"success"

data
object
required
request_id
string<uuid>
required