Skip to main content
sound: true switches the per-second billing rate from 0.399/s(noaudio)to0.399/s** (no audio) to **0.599/s (with audio). The default is false.

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 2500 characters.
integer
default:"5"
Length of the generated clip in seconds. Range [3, 15]. Drives billing: duration × rate.
"16:9" | "9:16" | "1:1"
default:"\"16:9\""
Aspect ratio of the generated video.
boolean
default:"false"
Whether to synthesize an audio track. Flips the per-second rate from 0.399/sto0.399/s to 0.599/s.
number
default:"0.5"
Classifier-free guidance strength. Range [0, 1]. Higher values follow the prompt more literally.
string
Content to steer the model away from. Max 2500 characters.

Example

Poll until terminal:

Reference