Authorizations
All endpoints require authentication using a Bearer Token. Get the API Key: Visit the API Key management page to obtain your API Key. Add the following in the request header: Authorization: Bearer YOUR_API_KEY
Body
Model name Fixed value: "sora2_pro"
Model parameters object Show params object properties
Text description for video generation No limit
Reference image URL for text-to-video (first frame)
Only supports single image
Supports publicly accessible URLs
Video aspect ratio Supported aspect ratios:
16:9 - Landscape (default)
9:16 - Portrait
Video duration (seconds) Supported durations:
10 - 10 seconds (default)
15 - 15 seconds
Video resolution Supported resolutions:
standard - Standard resolution (default)
high - High resolution
Requester task ID User-defined task identifier, required
Callback URL after task completion After completion, the system will send a POST request to this URL to notify the result
Custom metadata Returned as-is in query results, can be used for business identification
Response
Task ID, used to query the result
Initiator’s task ID, can be used to query the result
Initial status, fixed as "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_pro",
"params": {
"prompt": "A cat walking in the garden",
"aspect_ratio": "16:9",
"video_length": "15",
"resolution": "high"
},
"out_task_id": "my_task_123456"
}'
{
"statusCode" : 200 ,
"message" : "" ,
"data" : {
"task_id" : "order_p9EyMzcBxkH7zxQhlnP6k" ,
"out_task_id" : "my_task_123456" ,
"status" : "pending" ,
"estimated_credits" : 100 ,
"created_at" : "2025-12-22T06:03:28.242Z"
}
}