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

# GPT Image 2.6 Sunburst

> Generate and edit one 1K image with GPT Image 2.6, six quality settings and up to sixteen references.

OpenAI’s GPT Image 2.6 family includes Flare for fast iteration and Sunburst for detailed visual work. This model ID selects Sunburst directly; it cannot be changed to Flare. This integration delivers raster images at a fixed per-image price.

| Property | Value |
| - | - |
| Public model ID | `gpt-image-2.6-sunburst` |
| Resolution and count | `1K`, `n: 1` only |
| Price | \$0.01275 per delivered image (1.275 FreeModel credits) |
| Quality | `auto`, `low`, `medium`, `high`, `xhigh`, `max` |
| Output formats | PNG (default), JPEG or WebP |
| References | Up to 16 public URLs or PNG/JPEG/WebP Data URLs |

**100 FreeModel credits = \$1**. Both versions and all quality choices share the same image price. Reference images add no surcharge. See the [live model page](https://freemodel.app/models/gpt-image-2-6) for current availability.

**model** `string` *required*

Use `gpt-image-2.6-sunburst`.

**prompt** `string` *required*

A non-empty visual brief of at most 32,000 characters. For edits, explain what
to change and what to preserve.

**version** `string` (default: sunburst)

Only `sunburst` is valid on this model ID.

**resolution** `string` (default: 1K)

Only `1K` is accepted. 2K and 4K are not part of this route.

**n** `integer` (default: 1)

Only `1` is accepted. Submit separate tasks for multiple variants.

**size** `string` (default: auto)

`auto`, `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `5:4`, `4:5` or
`21:9`. Custom pixel dimensions are not accepted.

**quality** `string` (default: auto)

`auto`, `low`, `medium`, `high`, `xhigh` or `max`. Quality does not change the
image price; `auto` does not guarantee `low`.

**output\_format** `string` (default: png)

`png`, `jpeg` or `webp`.

**complexity** `string`

Optional: `low`, `medium` or `high` controls planning independently from
quality. It does not change the image price.

**image\_urls** `string[]`

Up to 16 public HTTP(S) image URLs or valid PNG, JPEG and WebP Base64 Data
URLs. Each image may be at most 20 MiB decoded, with at most 50 MiB decoded in
total. The whole JSON request remains subject to the gateway body cap (default
10 MiB); use public URLs for larger files.

This public route rejects unsupported or ignored controls, including `background`, `moderation`, `output_compression`, `mask_url`, `markup`, `markup_url`, pixel dimensions and vendor fallback switches. GIF and SVG output are not exposed.

## Generate an image

```bash theme={null}
curl https://api.freemodel.app/v1/images/generations \
  -H "Authorization: Bearer $FREEMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A ceramic coffee mug on a walnut table, soft window light, product photo",
  "version": "sunburst",
  "size": "1:1",
  "resolution": "1K",
  "quality": "high",
  "output_format": "png",
  "n": 1
}'
```

## Edit with a reference

```json theme={null}
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "Preserve the mug shape and label, replace only the background with warm linen",
  "version": "sunburst",
  "size": "1:1",
  "resolution": "1K",
  "quality": "high",
  "output_format": "png",
  "n": 1,
  "image_urls": ["https://example.com/reference-mug.png"]
}
```

## Receive results

A normal request waits for a terminal image result and returns `data[].url` on success. Send `Prefer: respond-async` for HTTP `202` and a gateway task ID. A waiting request may also return `202` if the task is still running. Use an `Idempotency-Key` for retries of the same submission.

```bash theme={null}
curl "https://api.freemodel.app/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $FREEMODEL_API_KEY"
```

Poll with the same API key until `succeeded` or `failed`. A successful task settles its delivered image against the original price version. Explicit failure or cancellation releases the reservation; uncertain results remain pending reconciliation. Repeated polling does not charge twice. Download temporary output URLs promptly.

> [card] [Open GPT Image 2.6](https://freemodel.app/models/gpt-image-2-6)
>
> Compare Flare and Sunburst in the Playground.


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