Skip to main content
POST
Sora
Realistic, physics-aware, fine control, audio-backed.

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

prompt
string
required

A text description of the video to generate

duration
default:4

Duration of the video in seconds

aspect_ratio
enum<string>
default:9:16

Aspect ratio of the video. Portrait is 720x1280, landscape is 1280x720

Available options:
9:16,
16:9
resolution
enum<string>
default:720p

Resolution of the generated video

Available options:
720p
first_frame_url
string<uri>

An optional image to use as the first frame of the video. The image must be the same aspect ratio as the video.

n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.