Skip to main content
The output dimension is the explicit size field (full pixel dimensions like "1920*1080") — it sets both the aspect ratio and the per-second price tier.

​
Endpoint

Async — returns {id, status: "pending"}; poll GET /v1/videos/generations/{id} until success or failed.

​
Parameters

​
string
required
Text prompt describing the desired video. Max 1500 characters.
​
enum
default:"\"1920*1080\""
Full pixel dimensions — sets the aspect ratio and the price tier. One of 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 (~2M px, 0.15/s∗∗),or‘1280∗720‘,‘720∗1280‘,‘960∗960‘,‘1088∗832‘,‘832∗1088‘( 0.9Mpx,∗∗0.15/s**), or `1280*720`, `720*1280`, `960*960`, `1088*832`, `832*1088` (~0.9M px, **0.10/s).
​
integer
default:"5"
Length of the generated clip in seconds. Range [2, 15]. Drives billing: duration × size-tier rate (see size).
​
string
Optional URL to a reference audio track. Public HTTPS, MP3 / WAV.
​
string
Content to actively steer the model away from. Max 500 characters.
​
boolean
default:"true"
Whether the model should expand and refine the prompt before generation.
​
boolean
default:"false"
Whether to overlay an upstream watermark on the output.
​
integer
Random-generator initialiser. Same seed + prompt + params produces deterministic output. Range [0, 2147483647].

​
Example

Poll until terminal:

​
Reference