Skip to main content

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 
gpt-image-2

​
gpt-image-2 API Usage Guide

​
Overview

gpt-image-2 is OpenAI’s latest image generation model. It excels at following complex prompts, rendering accurate text within images, and producing photorealistic outputs across a wide range of styles. Requests are synchronous and return results immediately.

​
Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header: 
Authorization: Bearer YOUR_API_KEY

​
Submit Image 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": "gpt-image-2",
    "payload": {
      "prompt": "A photograph of a red fox in an autumn forest",
      "size": "1024x1024",
      "quality": "medium",
      "output_format": "png",
      "n": 1
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
modelstringYesModel identifier-Must be "gpt-image-2"
payload.promptstringYesText description of the image to generate--
payload.sizestring (enum)NoDimensions of the generated image"1024x1024""1024x1024", "1024x1536", "1536x1024"
payload.qualitystring (enum)NoImage quality level, affects detail and cost"medium""low", "medium", "high", "auto"
payload.nintegerNoNumber of images to generate1Min: 1, Max: 10
payload.output_formatstring (enum)NoFile format of the generated image"png""png", "jpeg"
payload.imagestringNoBase64-encoded image to edit. Required when using image editing mode.--
payload.maskstringNoBase64-encoded mask for inpainting. White pixels are edited, black pixels are preserved.--

​
Response

{
  "request_id": "cd5b59d5-1b3f-4fd5-9899-15ecea1f28ba",
  "model": "gpt-image-2",
  "status": "success",
  "created_at": 1776797790,
  "updated_at": 1776797803,
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-video-assests/..."
      }
    ],
    "thumbnail_image_url": "https://storage.googleapis.com/gmi-video-assests/..."
  }
}

​
Request Status Values

StatusDescription
queuedRequest is waiting to be processed
successImage generation completed successfully
failedImage generation failed

​
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/cd5b59d5-1b3f-4fd5-9899-15ecea1f28ba" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
List Available Models

​
Endpoint

GET /api/v1/apikey/models

​
Example

curl -X GET "https://console.gmicloud.ai/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"