Videos

Get a video

GET /openai/v1/videos/{video_id}

Retrieves a video by its identifier.

Path parameters

video_id string required

The identifier of the video to retrieve.

Responses

The request has succeeded.

Body

Content-Type: application/json

id string required

Unique identifier for the video job.

object enum required

The object type, which is always video.

video

model string | enum required

Any of the following:

string

enum

sora-2sora-2-prosora-2-2025-10-06sora-2-pro-2025-10-06sora-2-2025-12-08

status enum required

queuedin_progresscompletedfailed

progress integer required

created_at integer required

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

completed_at integer | null required

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

expires_at integer | null required

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

prompt string | null required

size enum required

720x12801280x7201024x17921792x1024

seconds string required

Duration of the generated clip in seconds. For extensions, this is the stitched total duration.

remixed_from_video_id string | null required

error OpenAI.Error-2 | null required

An error that occurred while generating the response.

code string required

A machine-readable error code that was returned.

type string | null

param string | null

message string required

A human-readable description of the error that was returned.

headers object

The Retry-After and Retry-After-Ms headers returned with the original error, if any.

[key: string] string

misalignment OpenAI.MisalignmentErrorDetailsResource

review_target string | null

error_type string | enum

Any of the following:

string

enum

potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother

detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer

message string required

The public continuation instruction.

Request

import OpenAI from 'openai';

const client = new OpenAI();

const video = await client.videos.retrieve('video_123');

console.log(video.id);

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
video = client.videos.retrieve(
    "video_123",
)
print(video.id)

package main

import (
    "context"
    "fmt"

    "github.com/openai/openai-go"
    "github.com/openai/openai-go/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("My API Key"),
    )
    video, err := client.Videos.Get(context.TODO(), "video_123")
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("%+v
", video.ID)
}

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

video = openai.videos.retrieve("video_123")

puts(video)

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.videos.Video;
import com.openai.models.videos.VideoRetrieveParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        Video video = client.videos().retrieve("video_123");
    }
}

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env['OPENAI_API_KEY'], // This is the default and can be omitted
});

const video = await client.videos.retrieve('video_123');

console.log(video.id);