Skip to main content
Model ID 
sora-2-pro

​
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

​
Request Format

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

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringYesText description of the video to generate (max 2000 characters). Include scenes, actions, camera moves, and visual style.-Required
input_referencestringNoThe image MUST match the target video’s resolution (size).Supported file formats are: jpeg, png, and webp.-Max 1 image
secondsstringNoDuration of the video in seconds.”8”Options: “4”, “8”, “12”
sizestringNoVideo 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

StatusDescription
queuedRequest is waiting to be processed
processingVideo generation is in progress
successVideo generation completed successfully
failedVideo generation failed
cancelledRequest 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"

​
Get Model Information

​
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"
    ]
}