Skip to main content
POST
/
v1
/
sora
/
videos
curl --request POST \
  --url https://api.globalaiopc.com/sora/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "A cat dancing in the rain, cinematic style",
    "aspect_ratio": "16:9",
    "seconds": 10,
    "input_reference": [
      "https://example.com/reference1.jpg",
      "https://example.com/reference2.jpg"
    ]
  }'

{
  "id": "sora_abc123def456",
  "object": "video.generation",
  "created": 1761635478,
  "model": "sora-2",
  "status": "queued"
}

​
Sora Create Video Task

Create high-quality video generation tasks using Sora’s advanced AI models with support for multiple models and duration options.

​
Authentication

All requests require a Bearer token in the request header: 
Authorization: Bearer {{key}}

​
Request Parameters

​
model
string
required
Model name, available options:
  • sora-2 - Supports 10 or 15 seconds
  • sora-2-stable - Supports 10 or 15 seconds
  • sora-2-pro - Supports 10s (HD), 15s (HD), or 25s
​
prompt
string
required
Video generation prompt describing the desired video contentExample: "A cat dancing in the rain, cinematic style"
​
size
string
Video dimensions, defaults to 720x1280Available options:
  • 720x1280 - Portrait
  • 1280x720 - Landscape
Use either this or aspect_ratio, not both
​
aspect_ratio
string
Video aspect ratioAvailable options:
  • 16:9 - Landscape
  • 9:16 - Portrait
Use either this or size, not both
​
duration
integer
Video duration in seconds, supports 10 and 15
Use either this or seconds, not both
​
seconds
integer
Video duration in seconds, supports 10 and 15
Use either this or duration, not both
​
input_reference
array
Reference image array to guide video generation, supports up to 3 images
Use either this or image_urls, not both
​
image_urls
array
Reference image URL array to guide video generation
Use either this or input_reference, not both

​
Response Parameters

​
id
string
Unique identifier for the video generation task, used for subsequent status queries
​
object
string
Object type, always video.generation
​
created
integer
Task creation timestamp
​
model
string
Model name used
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
​
error
string
Error message, returned when status is failed

​
Model Features

sora-2

Standard model, supports 10 or 15 second video generation

sora-2-stable

Stable version model, supports 10 or 15 seconds with more stable output

sora-2-pro

Professional model, supports 10s (HD), 15s (HD), or 25s

​
Parameter Selection Rules

Mutually Exclusive Parameters:
  • Size parameters: Choose either size or aspect_ratio
  • Duration parameters: Choose either duration or seconds
  • Reference images: Choose either input_reference or image_urls

​
Video Duration Support

ModelSupported Durations
sora-210 seconds, 15 seconds
sora-2-stable10 seconds, 15 seconds
sora-2-pro10 seconds (HD), 15 seconds (HD), 25 seconds
Best Practices:
  1. Video generation is asynchronous, use the returned id to query task status and results
  2. Clearly describe desired visual effects and style in the prompt
  3. Reference images can guide overall style, supports up to 3 images
  4. Choose appropriate aspect ratio to match your use case
Prompt Suggestions:
  • Include specific scene descriptions
  • Add style keywords (e.g., “cinematic”, “artistic”, “realistic”)
  • Describe actions and movement patterns
  • Specify lighting and color preferences
curl --request POST \
  --url https://api.globalaiopc.com/sora/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "A cat dancing in the rain, cinematic style",
    "aspect_ratio": "16:9",
    "seconds": 10,
    "input_reference": [
      "https://example.com/reference1.jpg",
      "https://example.com/reference2.jpg"
    ]
  }'

{
  "id": "sora_abc123def456",
  "object": "video.generation",
  "created": 1761635478,
  "model": "sora-2",
  "status": "queued"
}