Skip to main content
Model ID 
gpt-image-2-generate
Calling method: sync

​
gpt-image-2-generate API Usage Guide

​
Overview

gpt-image-2-generate is OpenAI’s latest text-to-image model. It excels at following complex prompts, rendering accurate text within images, and producing photorealistic outputs across a wide range of styles.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Submit Image Generation Request

​
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-generate",
    "payload": {
      "prompt": "A photograph of a red fox in an autumn forest",
      "size": "1920x1080",
      "quality": "medium",
      "output_format": "png",
      "n": 1
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefault
modelstringYesModel identifier-
payload.promptstringYesText description of the image to generate-
payload.sizestring (enum)NoOutput resolution and aspect ratio"1920x1080"
payload.qualitystring (enum)NoImage quality level — affects detail and cost"medium"
payload.nintegerNoNumber of images to generate1
payload.output_formatstring (enum)NoFile format of the generated image"png"

​
Response

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

​
Pricing

Billing is based on the actual token consumption reported by OpenAI for each request. Users are charged according to the real usage of input text tokens, cached input text tokens, input image tokens, cached input image tokens, and output image tokens. The final cost may vary depending on prompt length, whether input images are provided, image size, quality, number of generated images, and other request parameters.

​
Token Pricing

Prices below are charged per 1M tokens:
Token TypePrice
Text input tokens$5.00 / 1M tokens
Cached text input tokens$1.25 / 1M tokens
Image input tokens$8.00 / 1M tokens
Cached image input tokens$2.00 / 1M tokens
Image output tokens$30.00 / 1M tokens

​
Billing Formula

Total cost =
  (text_input_tokens × $5.00 / 1,000,000)
+ (cached_text_input_tokens × $1.25 / 1,000,000)
+ (image_input_tokens × $8.00 / 1,000,000)
+ (cached_image_input_tokens × $2.00 / 1,000,000)
+ (image_output_tokens × $30.00 / 1,000,000)

​
Estimated Price Reference (per image)

The following table is provided as a reference only for common quality and resolution combinations. These are estimated per-image prices and may differ from the final billed amount, which is always based on actual token usage.
Quality1024x10241024x15361536x1024
Low$0.006$0.005$0.005
Medium$0.053$0.041$0.041
High$0.211$0.165$0.165

​
Check Request Status

GET /api/v1/ie/requestqueue/apikey/requests/{request_id}

​
Native OpenAI Format (Raw API)

Use the native OpenAI-compatible endpoint for direct integration with the OpenAI SDK or clients.

​
Base URL

https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/v1

​
Generate Image

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A red fox in an autumn forest",
    "size": "1024x1024",
    "quality": "medium",
    "output_format": "png",
    "n": 1
  }'

​
Native Parameters

ParameterTypeRequiredDescriptionDefaultNotes
modelstringYesMust be "gpt-image-2"-No other value accepted
promptstringYesText description--
sizestringNoWxH format"1024x1024"Both dimensions must be multiples of 16; max edge 3840px; aspect ratio ≤ 3:1
qualitystringNolow / medium / high / auto"medium"-
nintegerNoNumber of images (1–10)1Each image billed separately
output_formatstringNopng / jpeg"png"-
output_compressionintegerNoCompression level 0–100nullOnly valid for jpeg
backgroundstringNoauto / opaque"auto"-
moderationstringNoauto / low"auto"-

​
Native Response Format

{
  "created": 1780943845,
  "size": "1024x1024",
  "quality": "low",
  "output_format": "png",
  "data": [
    { "b64_json": "<base64-encoded-image>" }
  ],
  "usage": {
    "input_tokens": 16,
    "input_tokens_details": { "text_tokens": 16, "image_tokens": 0 },
    "output_tokens": 196,
    "output_tokens_details": { "image_tokens": 196, "text_tokens": 0 },
    "total_tokens": 212
  }
}

​
OpenAI SDK Usage

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/v1"
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="A red fox in an autumn forest",
    size="1024x1024",
    quality="medium"
)
print(response.data[0].b64_json)