# GPT Image 2.5 API (OpenAI)

> GPT Image 2.5 (Sunburst) is OpenAI's highest-quality image model: precise multi-image editing, reliable text and layout, five quality levels and output up to 4K.

Page: https://cheapergen.com/models/openai/gpt-image-2.5 · API reference: https://cheapergen.com/models/openai/gpt-image-2.5/api

## Pricing
Official list price source: OpenAI API list price for gpt-image-2.5-sunburst ($30 / 1M image output tokens, $5 / 1M text input, $8 / 1M image input). Prices verified 2026-10-16.

| Tier | Official | Cheaper Gen. | Save |
|---|---|---|---|
| 1K · low | $0.0074/image | $0.0066/image | 11% |
| 2K · low | $0.0134/image | $0.0118/image | 12% |
| 1K · medium | $0.0147/image | $0.0130/image | 12% |
| 2K · medium | $0.0285/image | $0.0251/image | 12% |
| 1K · high | $0.0545/image | $0.0480/image | 12% |
| 2K · high | $0.1085/image | $0.0955/image | 12% |

## Specs
- Resolutions: 1K · 2K · 4K
- Quality: low · medium · high · xhigh · max
- Aspect ratios: 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 21:9 · 9:21
- Edit inputs: Up to 16 images
- Model id (OpenAI): gpt-image-2.5-sunburst

## Endpoints

### Text to Image — `POST https://cheapergen.com/api/v1/run/openai/gpt-image-2.5/text-to-image`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| aspect_ratio | string (enum) (1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9, 9:21) | no | Output image shape. |
| resolution | string (enum) (1K, 2K, 4K) | no | Output size tier: 1K (≈1 MP), 2K (≈4 MP) or 4K (≈8 MP, experimental). |
| quality | string (enum) (low, medium, high, xhigh, max) | no | Rendering effort. Higher quality uses more output tokens and costs more; xhigh and max are for final assets. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/openai/gpt-image-2.5/text-to-image \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A minimalist poster for a jazz night called “BLUE HOUR”, saxophone silhouette, deep blue and brass, clean typography",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "quality": "medium"
}'
```

### Image Edit — `POST https://cheapergen.com/api/v1/run/openai/gpt-image-2.5/edit`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| image_urls | string[] (URLs) | yes | Up to 16 images to edit or combine. Refer to them as "image 1", "image 2"… in the prompt. |
| aspect_ratio | string (enum) (1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9, 9:21) | no | Output image shape. |
| resolution | string (enum) (1K, 2K, 4K) | no | Output size tier: 1K (≈1 MP), 2K (≈4 MP) or 4K (≈8 MP, experimental). |
| quality | string (enum) (low, medium, high, xhigh, max) | no | Rendering effort. Higher quality uses more output tokens and costs more; xhigh and max are for final assets. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/openai/gpt-image-2.5/edit \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Keep the product and its label exactly; replace the background with a soft off-white studio sweep and add a natural shadow",
  "image_urls": [
    "https://cdn.cheapergen.ai/samples/portrait.jpg"
  ],
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "quality": "medium"
}'
```

## Getting the result
Jobs are async. Poll `GET https://cheapergen.com/api/v1/generations/{id}` until status is succeeded/failed/canceled, or pass `webhook_url`. Failed generations are refunded automatically.

## FAQ
**How is GPT Image 2.5 priced?**
GPT Image 2.5 is billed per image by OpenAI's token rates: the quality level and resolution set the output tokens, and the prompt and each input image add input tokens. The price is shown before you run. Failed or refused generations are not charged.

**Which quality should I use?**
Low and medium are great for drafts and volume; high is the usual choice for finished images; xhigh and max spend far more tokens on detail for hero assets.

**Is this the official GPT Image 2.5?**
Yes. Requests run on OpenAI's GPT Image 2.5 model through an official OpenAI API channel, at a lower price than OpenAI's list price.

**Can I use the output commercially?**
Yes, subject to OpenAI's usage policies and our Terms of Service.

GPT Image 2.5 is developed by OpenAI. Cheaper Gen. provides API access and does not own the model.