Skip to main content
GET
Get video generation status
Poll this endpoint to track an async video job submitted via POST /v1/videos/generations.
The path segment is the id returned by the submit call — a UUID. Anything that is not a well-formed UUID answers 404. Response while running:
status is one of queued, processing, completed, failed. The terminal success value is completed. When done:

Sample output

Generated with veo-3-fast (4s, 16:9).

Polling guidance

Poll every 5 seconds. Most videos finish in 30–90 s; hard timeout is 1 hour.

Authorizations

Authorization
string
header
required

API key in format: Bearer inf_***

Path Parameters

jobId
string
required

Video generation job ID

Response

Video generation job status. result and credits_used are present when status === "completed"; error when status === "failed".

id
string
required
Example:

"0f9c3b1e-6d2a-4c17-9f83-2b5e7a41c8d0"

status
enum<string>
required
Available options:
queued,
processing,
completed,
failed
progress
integer
required

Progress percentage (0-100)

Example:

100

created
integer
required
Example:

1713204900

model
string
required
Example:

"veo-3.1-fast"

result
object

Present only when status is "completed"

Example:
credits_used
integer

Credits deducted. Present only on success.

Example:

180

error
string

Error message. Present only when status is "failed".