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

Parameter	Type	Required	Description	Default
`model`	string	Yes	Model identifier	-
`payload.prompt`	string	Yes	Text description of the image to generate	-
`payload.size`	string (enum)	No	Output resolution and aspect ratio	`"1920x1080"`
`payload.quality`	string (enum)	No	Image quality level — affects detail and cost	`"medium"`
`payload.n`	integer	No	Number of images to generate	`1`
`payload.output_format`	string (enum)	No	File 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 Type	Price
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.

Quality	1024x1024	1024x1536	1536x1024
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

Parameter	Type	Required	Description	Default	Notes
`model`	string	Yes	Must be `"gpt-image-2"`	-	No other value accepted
`prompt`	string	Yes	Text description	-	-
`size`	string	No	`WxH` format	`"1024x1024"`	Both dimensions must be multiples of 16; max edge 3840px; aspect ratio ≤ 3:1
`quality`	string	No	`low` / `medium` / `high` / `auto`	`"medium"`	-
`n`	integer	No	Number of images (1–10)	`1`	Each image billed separately
`output_format`	string	No	`png` / `jpeg`	`"png"`	-
`output_compression`	integer	No	Compression level 0–100	null	Only valid for `jpeg`
`background`	string	No	`auto` / `opaque`	`"auto"`	-
`moderation`	string	No	`auto` / `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)

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

gpt-image-2-generate

gpt-image-2-generate API Usage Guide

Overview

Authentication

Submit Image Generation Request

Endpoint

Request Format

Request Parameters

Response

Pricing

Token Pricing

Billing Formula

Estimated Price Reference (per image)

Check Request Status

Native OpenAI Format (Raw API)

Base URL

Generate Image

Native Parameters

Native Response Format

OpenAI SDK Usage

​gpt-image-2-generate API Usage Guide

​Overview

​Authentication

​Submit Image Generation Request

​Endpoint

​Request Format

​Request Parameters

​Response

​Pricing

​Token Pricing

​Billing Formula

​Estimated Price Reference (per image)

​Check Request Status

​Native OpenAI Format (Raw API)

​Base URL

​Generate Image

​Native Parameters

​Native Response Format

​OpenAI SDK Usage

gpt-image-2-generate API Usage Guide

Overview

Authentication

Submit Image Generation Request

Endpoint

Request Format

Request Parameters

Response

Pricing

Token Pricing

Billing Formula

Estimated Price Reference (per image)

Check Request Status

Native OpenAI Format (Raw API)

Base URL

Generate Image

Native Parameters

Native Response Format

OpenAI SDK Usage