cURL
Video Status (Legacy)
Poll the status of a video generation request submitted via /generate-video. Returns normalized status and the final video URL on completion.
GET
cURL
Overview
Poll the status of an asynchronous video generation run. Use therunId you received from POST /generate-video and include the model used for the request. When the run completes, the response includes data.output.video.url.
Deprecated: Use/api/video/statusfor all new integrations. This endpoint is kept for backwards compatibility and requires themodelquery parameter. See Video Status (Unified).
Query parameters
runId(string, required): The run identifier returned by the submit callmodel(string, required): The model used for the run (e.g.,veo2-video)
Usage
Status values
IN_QUEUE: Request queuedIN_PROGRESS: Generation in progressCOMPLETED: Video readyFAILED: Generation failedCANCELED: Request canceled
Response examples
In progress
Completed
Failed
Notes
- Polling this endpoint is free; submission endpoints are rate limited.
- The final video URL is returned in
data.output.video.urlwhen status isCOMPLETED. costis returned once the generation is complete.request_idmay be a NanoGPT job ID (vid_...) or a legacy provider request ID.