> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ekly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 2.5 Sunburst

> Detailed image generation and precise reference-image editing.

Detailed image generation and precise reference-image editing.

| | |
| - | - |
| Model id | `gpt-image-2.5-sunburst` |
| Media | image |
| Submit to | `POST /v1/images` |
| Price | 2.9 credits per\_generation before discounts |

## Request

**Required:** `prompt`\
**Optional:** `generate_image_count`, `gpt_image_preset`, `gpt_image_size`, `image_background`, `mask_image`, `moderation`, `output_format`, `image_quality`, `reference_images`

```json theme={null}
{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "A blue ceramic cup, three-quarter view, soft studio light, preserve the handle silhouette, transparent background. No text.",
  "generate_image_count": 1,
  "gpt_image_preset": "1:1",
  "gpt_image_size": "1024x1024",
  "image_background": "opaque",
  "moderation": "auto",
  "output_format": "png",
  "image_quality": "high"
}
```

| Field | Allowed | Default |
| - | - | - |
| `generate_image_count` | 1.0 – 4.0 | `1` |
| `gpt_image_preset` | `1:1`, `3:2`, `2:3`, `16:9`, `9:16`, `4:3`, `3:4`, `21:9` | `"1:1"` |
| `gpt_image_size` | `1536x864`, `2048x1152`, `3840x2160` | `"1024x1024"` |
| `image_background` | `opaque`, `transparent`, `auto` | `"opaque"` |
| `mask_image` | asset id (up to 1) | |
| `moderation` | `auto` | `"auto"` |
| `output_format` | `png`, `webp`, `jpeg` | `"png"` |
| `image_quality` | `high`, `medium`, `low`, `xhigh`, `max` | `"high"` |
| `reference_images` | asset ids (up to 5) | |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/gpt-image-2.5-sunburst` is always current.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.