Video API workflow
Endpoint Reference
Video API workflow
Submit, monitor, and download an asynchronous video task.
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
Poll every 10 to 20 seconds while
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 samemodel query value while polling and downloading.
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.