Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation
Theme

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Videos

Create a video
Deprecated
POST
/videos
Create a character
Deprecated
POST
/videos/characters
Delete a video
Deprecated
DELETE
/videos/{video_id}
Download video content
Deprecated
GET
/videos/{video_id}/content
Create a video edit
Deprecated
POST
/videos/edits
Create a video extension
Deprecated
POST
/videos/extensions
Retrieve a character
Deprecated
GET
/videos/characters/{character_id}
List videos
Deprecated
GET
/videos
Create a video remix
Deprecated
POST
/videos/{video_id}/remix
Retrieve a video
Deprecated
GET
/videos/{video_id}
Models
ImageInputReferenceParam object { file_id, image_url }
file_id: optional string
image_url: optional string

A fully qualified URL or base64-encoded data URL.

maxLength20971520
formaturi
Video object { id, completed_at, created_at, 10 more }

Structured information describing a generated video job.

id: string

Unique identifier for the video job.

completed_at: integer or null

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

formatunixtime
created_at: integer

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

formatunixtime
error: VideoCreateError { code, message, headers, 3 more } or null

Error payload that explains why generation failed, if applicable.

expires_at: integer or null

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

formatunixtime
model: VideoModel

The video generation model that produced the job.

object: "video" (default: "video")

The object type, which is always video.

progress: integer

Approximate completion percentage for the generation task.

prompt: string or null

The prompt that was used to generate the video.

remixed_from_video_id: string or null

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

seconds: string

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

size: VideoSize

The resolution of the generated video.

status: "queued" or "in_progress" or "completed" or "failed"

Current lifecycle status of the video job.

One of the following:
"queued"
"in_progress"
"completed"
"failed"
VideoCreateCharacterResponse object { id, created_at, name }
id: string or null

Identifier for the character creation cameo.

created_at: integer

Unix timestamp (in seconds) when the character was created.

formatunixtime
name: string or null

Display name for the character.

VideoCreateError object { code, message, headers, 3 more }

An error that occurred while generating the response.

code: string

A machine-readable error code that was returned.

message: string

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

headers: optional map[string]

Headers returned with the original error. These can include Retry-After, Retry-After-Ms, and, on opted-in deployments, x-openai-inference-capacity-reason.

misalignment: optional object { detailed_explanation, error_type, review_target, steer }
detailed_explanation: optional string

The public explanation for this block.

error_type: optional string or "potentially_unintended_data_transfer" or "potentially_unintended_data_access" or "potentially_unintended_destructive_activity" or "other"

An optional classification; clients must accept additional values.

One of the following:
string
SafetyAlertErrorType = "potentially_unintended_data_transfer" or "potentially_unintended_data_access" or "potentially_unintended_destructive_activity" or "other"

An optional classification; clients must accept additional values.

One of the following:
"potentially_unintended_data_transfer"
"potentially_unintended_data_access"
"potentially_unintended_destructive_activity"
"other"
review_target: optional string or null

An opaque target for explicitly continuing this review, or null when unavailable.

pattern^[A-Za-z0-9._~:-]+$
minLength1
maxLength96
steer: optional object { message }

An optional public continuation instruction.

message: string

The public continuation instruction.

param: optional string or null

The request parameter associated with the error, or null if none was recorded.

type: optional string or null

The original error type, or null if it was not recorded.

VideoDeleteResponse object { id, deleted, object }

Confirmation payload returned after deleting a video.

id: string

Identifier of the deleted video.

deleted: boolean

Indicates that the video resource was deleted.

object: "video.deleted" (default: "video.deleted")

The object type that signals the deletion response.

VideoGetCharacterResponse object { id, created_at, name }
id: string or null

Identifier for the character creation cameo.

created_at: integer

Unix timestamp (in seconds) when the character was created.

formatunixtime
name: string or null

Display name for the character.

VideoModel = string or "sora-2" or "sora-2-pro" or "sora-2-2025-10-06" or 2 more
One of the following:
string
"sora-2" or "sora-2-pro" or "sora-2-2025-10-06" or 2 more
One of the following:
"sora-2"
"sora-2-pro"
"sora-2-2025-10-06"
"sora-2-pro-2025-10-06"
"sora-2-2025-12-08"
VideoSeconds = "4" or "8" or "12"
One of the following:
"4"
"8"
"12"
VideoSize = "720x1280" or "1280x720" or "1024x1792" or "1792x1024"
One of the following:
"720x1280"
"1280x720"
"1024x1792"
"1792x1024"