Skip to main content
GET
cURL

Overview

Check the status of an asynchronous video generation job using a single, provider-agnostic endpoint. This endpoint accepts NanoGPT job IDs (vid_...) and legacy provider request IDs. No model parameter is required. Session ownership is enforced (returns 403 when the job is not yours).

Query parameters

*Send either requestId or runId.

Authentication

Provide x-api-key or a valid session cookie.

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:
  • Terminal results are cached in video_jobs for faster subsequent status checks.

Authorizations

x-api-key
string
header
required

Query Parameters

requestId
string
required

The unique request ID returned from any video generation endpoint

Response

Unified video generation status

requestId
string
required

The unique request ID for the video generation

status
enum<string>
required

Current normalized status of the video generation

Available options:
queued,
processing,
completed,
failed,
cancelled,
unknown
videoUrl
string | null
required

URL to the generated video (available when status is 'completed')

error
string | null
required

Error message if the generation failed

createdAt
string | null
required

ISO timestamp when the request was created

completedAt
string | null
required

ISO timestamp when the generation completed

progress
number | null

Generation progress as a percentage (0-100), if available

estimatedTimeRemaining
number | null

Estimated time remaining in seconds, if available