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-1.5

gpt-image-1.5 API Usage Guide

Overview

gpt-image-1.5 is OpenAI’s most capable image generation model, served via Azure Cognitive Services. 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-1.5",
    "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-1.5"
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", "webp"
payload.output_compressionintegerNoCompression level for JPEG/WebP output (0–100). Ignored for PNG.100Min: 0, Max: 100
payload.backgroundstring (enum)NoBackground style"auto""auto", "transparent", "opaque"
payload.imagestringNoBase64-encoded image to edit. Required for 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-1.5",
  "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"