Documentation Index
Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
Use this file to discover all available pages before exploring further.
Model ID
sora-2-pro API Usage Guide
Overview
Sora-2 Pro is a premium tier of OpenAI’s Sora video generation model. It provides enhanced quality, improved motion and temporal consistency, and supports longer durations and more aspect ratios. Ideal for professional creative workflows requiring higher fidelity and stability.
Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Submit Video Generation Request
Base URL
https://console.gmicloud.ai
Endpoint
POST /api/v1/ie/requestqueue/apikey/requests
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2-pro",
"payload": {
"prompt": "A majestic eagle soaring through a mountain landscape at sunset",
"input_reference": "https://example.com/reference_image.jpg",
"seconds": "8",
"size": "1280x720"
}
}'
Request Parameters
| Parameter | Type | Required | Description | Default | Constraints |
|---|
prompt | string | Yes | Text description of the video to generate (max 2000 characters). Include scenes, actions, camera moves, and visual style. | - | Required |
input_reference | string | No | The image MUST match the target video’s resolution (size).Supported file formats are: jpeg, png, and webp. | - | Max 1 image |
seconds | string | No | Duration of the video in seconds. | ”8” | Options: “4”, “8”, “12” |
size | string | No | Video resolution and aspect ratio. | ”1792x1024” | Options: “1792x1024”, “1024x1792”, “1280x720”, “720x1280” |
Response
{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"model": "sora-2-pro",
"status": "queued",
"created_at": 1750442925,
"updated_at": 1750442925,
"queued_at": 1750442925
}
Check Request Status
Endpoint
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"org_id": "your-org-id",
"user_id": "your-user-id",
"model": "sora-2-pro",
"status": "success",
"is_public": false,
"payload": {
"prompt": "A majestic eagle soaring through a mountain landscape at sunset",
"input_reference": "https://example.com/reference_image.jpg",
"seconds": "8",
"size": "1280x720"
},
"outcome": {
"video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
"thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
},
"created_at": 1750442925,
"updated_at": 1750442930,
"queued_at": 1750442925
}
Request Status Values
| Status | Description |
|---|
queued | Request is waiting to be processed |
processing | Video generation is in progress |
success | Video generation completed successfully |
failed | Video generation failed |
cancelled | Request was cancelled |
List Your Requests
Endpoint
GET api/v1/ie/requestqueue/apikey/requests?model_id=sora-2-pro
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=sora-2-pro" \
-H "Authorization: Bearer YOUR_API_KEY"
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/sora-2-pro
Example
curl -X GET "https://api.example.com/api/v1/apikey/models/sora-2-pro" \
-H "Authorization: Bearer YOUR_API_KEY"
List Available Models
Endpoint
GET /api/v1/apikey/models
Example
curl -X GET "https://api.example.com/api/v1/apikey/models" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"model_ids": [
"sora-2-pro",
"other-model-1",
"other-model-2"
]
}
