Skip to main content

Endpoint

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

Parameters

string
required
Text prompt describing motion and changes from the source image. Max 5000 characters.
string[]
required
Exactly one source-image URL (PNG / JPEG, publicly accessible over HTTPS).
"720P" | "1080P"
default:"\"1080P\""
Output resolution. Drives the per-second rate (0.10/svs0.10/s vs 0.15/s).
integer
default:"5"
Length of the generated clip in seconds. Range [2, 15].
string
Optional public HTTPS URL pinning the final frame of the output.
string
Optional URL to a reference audio track used to drive motion / lip sync.
string
Content to steer the model away from. Max 500 characters.
boolean
default:"true"
Whether the model should expand the prompt before generation.
boolean
default:"false"
Whether to overlay an upstream watermark on the output.
integer
Random-generator initialiser. Range [0, 2147483647].

Example

Poll until terminal:

Reference