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 the following to the request headers: Authorization: Bearer YOUR_API_KEY
Body
Model name Fixed value: "veo3_1"
Model parameters object Show params object properties
Text description for video generation No limitations
Reference image URL for image-to-video (first frame)
Supports only a single image
Must be a publicly accessible URL
Reference image URL for the last frame
Supports only a single image
Must be a publicly accessible URL
Video aspect ratio Supported aspect ratios:
16:9 - Landscape (default)
9:16 - Portrait
Initiator task ID User-defined task identifier, required
Callback notification URL upon task completion After task completion, the system will send a POST request to this URL to notify the result
Custom metadata Returned as-is when querying results, can be used for business identification
Response
Task ID, used for querying results
Initiator’s Task ID, can be used to query results
Initiator’s Task ID, can be used to query results
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": "veo3_1",
"params": {
"prompt": "Make this image move",
"image_url": "https://example.com/reference.jpg",
"aspect_ratio": "16:9"
},
"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"
}
}