Skip to main content
POST
Submit Veo 3.1 task

Submit task

prompt and type are required. Use text-to-video without images, image-to-video with one or two frame images, or reference-to-video with one to three reference images.
Public variants are veo3_fast and veo3_lite; resolution is 720p, 1080p, or 4k. Variant and resolution select a fixed per-video charge, so 4, 6, and 8 seconds cost the same. Reference-to-video requires 8 seconds. Save data.task_id and poll /api/v1/task/status.

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 requires 1-2 images; reference-to-video requires 1-3 images and duration 8.

type
enum<string>
required
Available options:
text-to-video
prompt
string
required
Minimum string length: 1
image_urls
string<uri>[]
Maximum array length: 3

Publicly reachable HTTP(S) URL.

Pattern: ^https?://
duration
enum<integer>
default:8
Available options:
4,
6,
8
resolution
enum<string>
default:720p
Available options:
720p,
1080p,
4k
aspect_ratio
enum<string>
default:16:9
Available options:
16:9,
9:16,
Auto,
auto
model
enum<string>
default:veo3_fast
Available options:
veo3_fast,
veo3_lite
seeds
integer
Required range: 10000 <= x <= 99999
enable_translation
boolean
watermark
string
Maximum string length: 128

Response

Task accepted

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

"success"

data
object
required
request_id
string<uuid>
required