Skip to main content

Endpoint

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

Pricing

Per-second pricing by resolution — see Video Generation. Optional audio +$0.064.

Parameters

string
required
Text prompt; address references as @1, @2, … Max 2000 characters.
string[]
required
1–7 reference images (public HTTPS or base64); each becomes a subject @1, @2, …
integer
default:"5"
Clip length in seconds. 1–10s (default 5).
enum
default:"720p"
Output resolution. One of 540p / 720p / 1080p.
enum
default:"16:9"
One of 16:9, 9:16, 1:1.
boolean
default:"false"
Generate a matching audio track (+$0.064).
enum
default:"auto"
Camera/subject motion. One of auto, small, medium, high.
boolean
default:"false"
Add an auto-generated background music track.
integer
Random-generator initialiser. Range [0, 2147483647].

Example

See also

Full request/response schema and pricing: Video Generation.