OpenAI API (unofficial showcase)
GET/videos/{video_id}Deprecated

Retrieve video metadata

Retrieves the latest metadata for a generated video. Use video_id to identify the video job and check its current status, progress, and other job details.

1 parameter
video_idstringrequired
The identifier of the video to retrieve.

3 status codes
200Returns the video job metadata, including its identifier, status, progress, prompt, resolution, duration, and timestamps.
idstringrequired
Unique identifier for the video job.
objectstringrequired
The object type, which is always `video`.
Allowed:videoDefault:video
modelstringrequired
The video generation model that produced the job.
statusstringrequired
Current lifecycle status of the video job.
Allowed:queuedin_progresscompletedfailed
progressintegerrequired
Approximate completion percentage for the generation task.
created_atintegerrequired
Unix timestamp (seconds) for when the job was created.
completed_atintegerrequired
Unix timestamp (seconds) for when the job completed, if finished.
expires_atintegerrequired
Unix timestamp (seconds) for when the downloadable assets expire, if set.
promptstringrequired
The prompt that was used to generate the video.
sizestringrequired
The resolution of the generated video.
Allowed:720x12801280x7201024x17921792x1024
secondsstringrequired
Duration of the generated clip in seconds. For extensions, this is the stitched total duration.
remixed_from_video_idstringrequired
Identifier of the source video if this video is a remix.
errorobjectrequired
Error payload that explains why generation failed, if applicable.
400Returned when the request is invalid or the organization does not support video generation.
errorobjectrequired
404Returned when the video was not found or is not accessible, or the Videos API is unavailable.
errorobjectrequired

Error handling

A 400 is returned when the request is invalid or video generation is unsupported. A 404 is returned when the video is not found or accessible, or the Videos API is unavailable; the video_id path parameter must identify a video you can access.