Skip to main content
POST
Create Video Generation Task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
model
enum<string>
required

Video generation model ID.

Available options:
sora-2
Example:

"sora-2"

prompt
string
required

Natural language description of the video. Include shot type, subject, action, setting, lighting, and desired camera movement for best results. Keep it single-purpose for optimal adherence.

Example:

"A cat walking through a sunflower field at golden sunset"

seconds
enum<string>
default:4

Video duration in seconds.

Available options:
4,
8,
12
Example:

"12"

size
enum<string>
default:720x1280

Output resolution in width x height format.

Available options:
720x1280,
1280x720,
1024x1792,
1792x1024
Example:

"1280x720"

input_reference
file

Optional reference image used as the first frame. Accepted MIME types: image/jpeg, image/png, image/webp.

remix_video_id
string

ID of a previously completed video (e.g. video_...) to reuse its structure, motion, and framing.

Example:

"video_69b131ea03548190925a6a06febf993b"

Response

Task created

id
string

Video task ID

Example:

"video_69b131ea03548190925a6a06febf993b"

object
string
Example:

"video"

model
string
Example:

"sora-2"

status
string
Example:

"queued"

progress
integer
Example:

0

created_at
integer
Example:

1773220330

seconds
string
Example:

"12"

size
string
Example:

"1280x720"