# GPT Image 2.5 Flare · Edit

Edit and enhance images with GPT Image 2.5 Flare · Edit from OpenAI through one Spiral API key. Edits images from a text instruction with GPT Image 2.5 Flare, using up to 16 input images and an optional mask for the area. It runs in the background and returns images. Pay as you go, with no subscription.

- Provider: OpenAI
- Category: Image
- Runs: In the background
- Returns: image
- Released: 2026-09-08
- Tool id: `openai` / `gpt-image-2.5-flare/edit`
- Page: https://spiral.ai/tools/openai/gpt-image-2.5-flare/edit

## Pricing

$0.0686 per 1024×1024 image at high quality ($0.00775 low, $0.0172 medium, $0.122 xhigh, $0.274 max), plus each input image. At high: $0.0536 at 1536×1024 or 1024×1536, $0.0486 at 1792×1024 or 1024×1792, $0.0509 at 512×512, $0.0465 at 256×256. Auto quality or size: the price of the one chosen for the request. Prompt: $6.50 per 1M tokens. Input images: $0.0106 each at 1024×1024.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `images` (required) | JSON |  | — | Input image references to edit. For the GPT image models, each image should be a png, webp or jpg file less than 50MB; up to 16 images. |
| `prompt` (required) | text |  | — | A text description of the desired image(s). The maximum length is 32000 characters for the GPT image models. |
| `n` | number (whole) | 1 to 10 | 1 | The number of images to generate. Must be between 1 and 10. |
| `mask` | JSON |  | — | An additional image whose fully transparent areas (e.g. where alpha is zero) indicate where the first image should be edited. If there are multiple images provided, the mask will be applied on the first image. Must be a valid PNG file, less than 4MB, and have the same dimensions as the first image. |
| `size` | JSON |  | auto | The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`. Width and height must both be divisible by 16 and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and the maximum supported resolution is `3840x2160`. The requested size must also satisfy the model's current pixel and edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models; `auto` is supported for models that allow automatic sizing. |
| `quality` | one of | low, medium, high, xhigh, max, auto | auto | The quality of the image that will be generated. - `auto` (default value) will automatically select the best quality for the given model. - `high`, `medium` and `low` are supported for the GPT image models. - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support `xhigh` and `max`. |
| `background` | one of | transparent, opaque, auto | auto | Set the background of the generated image(s). This parameter is only supported for the GPT image models. Must be one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used, the model will automatically determine the best background for the image. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, support `opaque` and `transparent` backgrounds. Transparent backgrounds are available for supported GPT Image models. For `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`, set the output format to `png` or `webp`. |
| `output_format` | one of | png, jpeg, webp | png | The format in which the generated images are returned. This parameter is only supported for the GPT image models. Must be one of `png`, `jpeg`, or `webp`. |
| `output_compression` | number (whole) |  | 100 | The compression level (0-100%) for the generated images. This parameter is only supported for the GPT image models with the `webp` or `jpeg` output formats, and defaults to 100. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "openai",
    "model": "gpt-image-2.5-flare/edit",
    "input": {
      "images": [
        {
          "image_url": "<image_url>"
        }
      ],
      "prompt": "A cute baby sea otter wearing a beret"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=openai&model=gpt-image-2.5-flare%2Fedit

## Common questions

### GPT Image 2.5 Flare · Edit

**How much does GPT Image 2.5 Flare · Edit cost?**

$0.0686 per 1024×1024 image at high quality ($0.00775 low, $0.0172 medium, $0.122 xhigh, $0.274 max), plus each input image. At high: $0.0536 at 1536×1024 or 1024×1536, $0.0486 at 1792×1024 or 1024×1792, $0.0509 at 512×512, $0.0465 at 256×256. Auto quality or size: the price of the one chosen for the request. Prompt: $6.50 per 1M tokens. Input images: $0.0106 each at 1024×1024. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use GPT Image 2.5 Flare · Edit through an API?**

Send `POST /v1/runs` with `"provider": "openai"`, `"model": "gpt-image-2.5-flare/edit"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with OpenAI to use GPT Image 2.5 Flare · Edit?**

No. Spiral runs it on its own OpenAI account and charges your Spiral balance.

**Can my AI agent use GPT Image 2.5 Flare · Edit?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

