Skip to main content
POST /videos/generations produces a video in one of three modes, selected by the mode field:
  • image_to_video — animate a start frame, with an optional end frame on end-frame-capable engines.
  • text_to_video — generate a clip from a prompt alone.
  • text_to_video_styled — a prompt plus your organization’s trained models.
Engine capabilities (supported modes, durations, resolutions, aspect ratios, end-frame and audio support, and pricing) come from GET /videos/models — read it first to pick a valid engine + duration combination.

​
Asynchronous pattern

POST /videos/generations returns 202 Accepted with a job id; poll GET /videos/generations/{id} until completed, then read the produced video (presigned URL valid 24 hours). A webhook_url gives you a push callback — see Webhooks.

​
Credits

Video credits scale with the engine’s per-second rate, duration, resolution multiplier, and audio multiplier — see credits_per_second and the multipliers in GET /videos/models. Costs draw from your organization’s pool; an exhausted pool returns 402. See Pricing.