Generate Video
Video endpoints turn a prompt, a first frame or a set of references into a video clip. Every video request runs asynchronously: it returns a generation_id straight away, and you collect the video by polling or through a webhook.
Choose how to start
All of them are POST /v2/video/generate/{endpoint}. Choose a model compares their lengths and inputs.
Write the prompt
Describe the motion, the camera and how the shot changes over time, not only what is in the frame. In reference to video and Kling 4.0, refer to each reference by its position, as in [Image1] walks toward the camera for Seedance and Kling, or Image 1 walks toward the camera for MiniMax H3.
The longest prompt each model takes:
Set length, size and audio
Each endpoint’s reference lists its exact values.
Submit and collect the video
A completed video’s result has an object_type of video.generation, with url, asset_id, prompt, resolution, aspect_ratio and duration. The link expires after 24 hours, so download the file. If your deadline passes while the status is still pending, keep the generation_id and check again later instead of sending the request again: a second request is a second, billed video. See Idempotency and safe retries.
Videos take longer than images, so in production prefer a webhook and keep polling as a fallback. Build a reliable production integration walks through the whole lifecycle.
What a video costs
Video is billed per second of output at the provider’s list rate, so the price depends on the model, duration, resolution and audio. Add dry_run=true to the request to get its price without running it:
See Price quotes for the response and API pricing for every rate.
When a video fails
A failed generation has status: failed and a failure_reason, such as content_policy_violation, and it isn’t billed. A prompt that fails the safety check before the video starts returns 422 and isn’t billed either. See Errors and billing.
In the app
The Ideogram app makes video from the same models without code. See Create Videos in the user guide.