Skip to main content
GET
Poll video generation status

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Path Parameters

jobId
string
required
Minimum string length: 1
Example:

"job-abc123"

Response

Video generation status

id
string
required

The video job ID, in the gen-vid-<timestamp>-<20 alphanumerics> generation ID format. Pass it as previous_job_id to continue the generation.

polling_url
string
required
status
enum<string>
required
Available options:
pending,
in_progress,
completed,
failed,
cancelled,
expired
error
string
expires_at
integer

Unix timestamp in seconds when OpenRouter's stored copy of the outputs stops being available. Present only when that copy exists.

generation_id
string

The generation ID associated with this video generation job. Available once the job has been processed.

progress
number<double>

Percent complete, from 0 to 100 and possibly fractional, reported by the provider while status_detail is generating. Present only for providers that report it, and absent once the job moves to finalizing.

Required range: 0 <= x <= 100
status_detail
enum<string>

The step within status for a job that is not finished: submitting and queued_at_provider under pending, generating and finalizing under in_progress. When present, it only moves forward, and steps may be skipped between polls. It is absent once the job is finished and can also be absent mid-job when the step is unknown, so use status to tell whether the job is finished.

Available options:
submitting,
queued_at_provider,
generating,
finalizing
unsigned_urls
string[]

OpenRouter content URLs for each output. They need your API key in the Authorization header and keep working for as long as the output is available.

urls
string[]

Signed download URLs for OpenRouter's stored copy of each output, usable without an API key until expires_at. Anyone holding a URL can download that output until it expires, so treat it like a secret. Present only when the stored copy exists.

usage
object

Usage and cost information for the video generation. Available once the job has completed.

Example: