Sign in

v32

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-312881,4162.7 MB
Videos

Retrieve video

Fetch the latest metadata for a generated video.

get/videos/{video_id}

Path parameters

video_idstring required
Example:video_123

The identifier of the video to retrieve.

Response

Success

idstring required

Unique identifier for the video job.

object'video' required

The object type, which is always video.

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

Approximate completion percentage for the generation task.

created_atinteger required

Unix timestamp (seconds) for when the job was created.

completed_atinteger nullable required

Unix timestamp (seconds) for when the job completed, if finished.

expires_atinteger nullable required

Unix timestamp (seconds) for when the downloadable assets expire, if set.

promptstring nullable required

The prompt that was used to generate the video.

size'720x1280' | '1280x720' | '1024x1792' | '1792x1024' required
remixed_from_video_idstring nullable required

Identifier of the source video if this video is a remix.