> ## 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.

# gpt-image-2-generate

> API usage guide for gpt-image-2-generate.

{/* source_model_id: gpt-image-2-generate */}

{/* source_updated_at: 1781739075 */}

**Model ID**

```bash theme={null}
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

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Image Generation Request

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
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

```json theme={null}
{
  "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

```text theme={null}
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

```bash theme={null}
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

```json theme={null}
{
  "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

```python theme={null}
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)
```