Skip to main content
POST

Authorization

string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd to the request header:

Request Parameters

string
default:"sora-2"
required
Video generation model nameExample: "sora-2"
string
required
Text description for video generation
integer
Video duration in secondsExample: 5
string
Video aspect ratioSupported formats:
  • 16:9 (Landscape)
  • 9:16 (Portrait)
array<url>
Array of reference image URLs for image-to-video generationSupports publicly accessible image URLs (http:// or https://)Example: ["https://example.com/image.jpg"]Limitations:
  • Maximum file size: 10MB
  • Supported formats: .jpeg, .jpg, .png, .webp

Response

integer
Task creation timestamp
string
Unique task identifier
string
The actual model name used
string
Object type, fixed as video.generation.task
integer
Task completion progress percentage (0-100)
string
Task statusPossible values:
  • pending - Waiting for processing
  • processing - In progress
  • completed - Completed
  • failed - Failed
object
Task details
string
Output type, fixed as video
object
Billing information