Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

​
Sora 2 Pro Official

sora-2-pro-official supports text-to-video generation and optional single-image guided generation with fixed 4s, 8s, 12s, 16s, and 20s durations.

​
Available Model

  • sora-2-pro-official - Pro text-to-video and image-guided video generation

​
Required Parameters

  • prompt: Text prompt for video generation

​
Optional Parameters

  • duration: 4, 8, 12, 16, or 20. Default is 4
  • resolution: 720p, 1024p, or 1080p. Default is 1024p
  • aspect_ratio: 16:9 or 9:16 for text-to-video; auto, 16:9, or 9:16 for image-to-video. Default is 16:9 for text-to-video and auto for image-to-video
  • image_urls: Optional reference image array. Maximum 1 image

​
Credit Billing

Billing is calculated from duration and resolution.
  • 720p: 48 credits per second
  • 1024p: 80 credits per second
  • 1080p: 112 credits per second
For example, an 8-second 1024p video uses 640 credits.

​
Notes

  • image_urls is optional. If provided, only one image is supported.
  • aspect_ratio=auto is only valid when image_urls is provided.
  • Query status through the standard task status API.

Authorizations

​
Authorization
string
header
required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Body

application/json
​
model
enum<string>
required

Sora 2 Pro Official model identifier

Available options:
sora-2-pro-official
​
input
object
required
​
callback_url
string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

Task submitted successfully

​
code
integer
required
Example:

200

​
data
object
required