Authorizations
All endpoints require authentication using a Bearer Token Get the API Key: Visit the API Key management page to get your API Key Add to the request headers when using: Authorization: Bearer YOUR_API_KEY
Body
Model name Fixed value: "sora2"
Model parameters object Show params object properties
Text description for video generation No limit
Reference image URL, used for image-to-video (first frame)
Only a single image is supported
Supports publicly accessible URLs
Video aspect ratio Supported aspect ratios:
16:9 - Landscape (default)
9:16 - Portrait
Video length (seconds) Supported lengths:
10 - 10 seconds (default)
15 - 15 seconds
Initiator task ID User-defined task identifier, required
Callback URL after task completion The system will send a POST request to this URL to notify the result after the task is completed
Custom metadata Returned as-is when querying results, can be used for business identification
Response
Task ID used to query the result
Initiator task ID, can be used to query the result
Initial status, fixed to "pending"
Estimated consumed credits
Creation time (ISO format)
cURL
Python
JavaScript
Go
Java
PHP
Ruby
Swift
C#
C
Objective-C
OCaml
Dart
R
curl --request POST \
--url https://test.aireiter.com/api/openapi/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "sora2",
"params": {
"prompt": "A cat walking in the garden",
"aspect_ratio": "16:9",
"video_length": "10"
},
"out_task_id": "my_task_123456"
}'
{
"statusCode" : 200 ,
"message" : "" ,
"data" : {
"task_id" : "order_p9EyMzcBxkH7zxQhlnP6k" ,
"out_task_id" : "my_task_123456" ,
"out_task_id" : "my_task_123456" ,
"status" : "pending" ,
"estimated_credits" : 100 ,
"created_at" : "2025-12-22T06:03:28.242Z"
}
}