Skip to main content
POST
Video API workflow
All SnapGen video routes use the same asynchronous workflow. Choose a model from the Video Series sidebar, submit a request, save the returned id, and poll until the task completes. The model page defines the accepted duration, aspect ratio, resolution, and reference-image rules. Do not send values from one model family to another.
string
required
An available video model ID. Call GET /v1/models and select a model whose supported_endpoint_types includes openai-video.
string
required
Describe the subject, action, camera movement, lighting, and audio intent.
string
required
A model-specific duration. Use the exact value documented on the selected model page.
string
Gemini Omni only. Pass pixel dimensions such as 1280x720.
string
Seedance 2 and Veo 3.1 only. Do not send size with these routes.
string[]
Public http or https reference URLs when the selected model accepts them.
string
Optional public callback URL. SnapGen sends the final task object when the task completes or fails.

Submit a task

Poll and download

Include the same model query value while polling and downloading.
Poll every 10 to 20 seconds while status is queued or in_progress. Download only after status becomes completed.

Task status API

Query the normalized task record and final media URLs.

Webhooks

Receive the final task result without continuous polling.