Sign in
Videos

Retrieve a video generation job

Retrieves a video generation job. The gateway keeps no job state, so the request is forwarded to the provider that created the job; pass provider when the job id alone is not enough to route it.

get/videos/{video_id}

Path parameters

video_idstring required

The id of the video generation job, as returned by POST /videos. Opaque to clients - it may encode the provider - and must be sent back verbatim.

Query parameters

provider'ollama' | 'ollama_cloud' | 'groq' | 'llamacpp' | 'openai' | 'cloudflare' | 'cohere' | 'anthropic' | 'deepseek' | 'elevenlabs' | 'google' | 'mistral' | 'minimax' | 'moonshot' | 'nvidia' | 'zai'

Specific provider to use (default determined by the job id)

Response

The video generation job.

idstring required

Identifier of the video generation job. Opaque to clients - it may encode the provider - and must be sent back verbatim to GET /videos/{video_id}.

object'video' required

The object type, which is always video.

modelstring required

The model used to generate the video.

status'queued' | 'in_progress' | 'completed' | 'failed' required

Current status of the job.

progressinteger

Completion percentage of the render.

created_atinteger required

Unix timestamp (in seconds) of when the job was created.

completed_atinteger nullable

Unix timestamp (in seconds) of when the job finished, null while it is still running.

secondsstring

Duration of the generated video in seconds, as a string.

sizestring

Resolution of the generated video as widthxheight.

Changes

Changed in 1 of the 77 revisions of this API.1