Skip to main content
POST
Submit PixVerse V6 task

Submit task

prompt and type are required. image-to-video takes 1 public HTTP(S) image URL, or 2 for a first/last-frame transition (duration 5 or 8 only), and must omit aspect_ratio (HTTP 422 otherwise). reference-to-video takes 1–7 images. text-to-video must omit image_urls.
The gateway charges per second by resolution and audio: 360p = 31 / 47, 540p = 47 / 62, 720p = 62 / 77, 1080p = 124 / 154 credits (silent / with audio). 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, or 2 images for a first/last-frame transition (duration 5 or 8 only), and must omit aspect_ratio because the output follows the input image. reference-to-video fuses 1-7 reference images. Billed per second by resolution and generate_audio.

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

Required prompt, at most 5000 Unicode characters.

Required string length: 1 - 5000
image_urls
string<uri>[]
Maximum array length: 7

Publicly reachable HTTP(S) URL.

Pattern: ^https?://
aspect_ratio
enum<string>

Text-to-video and reference-to-video only; defaults to 16:9. Rejected for image-to-video.

Available options:
16:9,
4:3,
1:1,
3:4,
9:16,
2:3,
3:2,
21:9
resolution
enum<string>
default:540p
Available options:
360p,
540p,
720p,
1080p
duration
integer
default:5
Required range: 1 <= x <= 15
generate_audio
boolean
default:false

Add an audio track. Audio selects a higher per-second rate.

negative_prompt
string
Maximum string length: 2048
seed
integer
Required range: 0 <= x <= 2147483647

Response

Task accepted

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

"success"

data
object
required
request_id
string<uuid>
required