Skip to main content
GET
cURL

Overview

Poll the status of an asynchronous video generation run. Use the runId 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/status for all new integrations. This endpoint is kept for backwards compatibility and requires the model query parameter. See Video Status (Unified).

Query parameters

  • runId (string, required): The run identifier returned by the submit call
  • model (string, required): The model used for the run (e.g., veo2-video)

Usage

Status values

  • IN_QUEUE: Request queued
  • IN_PROGRESS: Generation in progress
  • COMPLETED: Video ready
  • FAILED: Generation failed
  • CANCELED: 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.url when status is COMPLETED.
  • cost is returned once the generation is complete.
  • request_id may be a NanoGPT job ID (vid_...) or a legacy provider request ID.

Authorizations

x-api-key
string
header
required

Query Parameters

runId
string
required

Run ID returned from the POST /generate-video response

model
string

Model identifier used in the generation request (e.g., 'veo2-video')

Response

Current status for the requested video generation

data
object