# GPT Image 2.5 Sunburst

> Run GPT Image 2.5 Sunburst by openai online or via API. $0.006-$0.21 per 1024x1024 image: low $0.006, medium $0.013, high $0.053, xhigh $0.094, max $0.21. Larger sizes cost more; edits add ~$0.008 per reference image., no setup.

**URL:** https://inference.sh/apps/openai/gpt-image-2-5-sunburst
**Last updated:** 2026-09-08

---

GPT Image 2.5 Sunburst — OpenAI's most capable image model, built for premium creative and editing workflows with tighter control across edits. Text-to-image, reference-image editing, mask inpainting, transparent backgrounds, quality up to max.

- app: `openai/gpt-image-2-5-sunburst`
- maker: [openai](https://inference.sh/apps/openai.md)
- category: [image](https://inference.sh/apps/category/image.md)
- input → output: text → image
- tasks: [text to image](https://inference.sh/apps/tag/text-to-image.md), [image editing](https://inference.sh/apps/tag/image-editing.md)
- price: $0.006-$0.21 per 1024x1024 image: low $0.006, medium $0.013, high $0.053, xhigh $0.094, max $0.21. Larger sizes cost more; edits add ~$0.008 per reference image.
- runs via: api, javascript and python sdk, belt cli, mcp

## gpt-image-2-5-sunburst API Guide

### About
gpt image 2.5 sunburst — openai's most capable image model, built for premium creative and editing workflows with tighter control across edits. text-to-image, reference-image editing, mask inpainting, transparent backgrounds, quality up to max.

### 1. Calling the API

#### Install the Client

```bash
pip install inferencesh
```

#### Setup Your API Key
Set `INFERENCE_API_KEY` as an environment variable. Get your key from settings → api keys.

```bash
export INFERENCE_API_KEY="inf_your_key"
```

#### Run and Get Result

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


result = client.run({
        "app": "openai/gpt-image-2-5-sunburst@2n1ym7fw",
        "input": {
            "prompt": "A cat wearing a tiny top hat, oil painting style"
        }
    })

print(result["output"])
```

#### Stream Live Updates

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


## stream=True yields updates as they arrive
for update in client.run({
        "app": "openai/gpt-image-2-5-sunburst@2n1ym7fw",
        "input": {
            "prompt": "A cat wearing a tiny top hat, oil painting style"
        }
    }, stream=True):
    if update.get("progress"):
        print(f"progress: {update['progress']}%")
    if update.get("output"):
        print(f"output: {update['output']}")
```

### 2. Authentication
The API uses API keys for authentication. See the authentication docs for detailed setup instructions.

### 3. Files

#### Automatic Upload

```python
## local file paths are automatically uploaded
result = client.run({
    "app": "openai/gpt-image-2-5-sunburst@2n1ym7fw",
    "input": {
        "image": "/path/to/local/image.png",  # detected & uploaded
        "audio": "https://example.com/audio.mp3",  # url passed through
    }
})
```

#### Manual Upload

```python
## upload and get a hosted URL
file = client.files.upload("/path/to/file.png")
print(file.uri)  # https://cloud.inference.sh/...
```

### 4. Schema

#### Input
- **prompt** (string) *required*: Text prompt describing the desired image.
- **images** (array): Optional reference image(s) for editing. When a mask is provided, it applies to the first image.
- **mask** (string): Optional mask image indicating areas to edit (requires input images). Transparent areas in the mask indicate where the image should be edited. Applied to the first image.
- **width** (integer): Output image width in pixels. Must be a multiple of 16.
- **height** (integer): Output image height in pixels. Must be a multiple of 16.
- **quality** (string): Rendering quality. 'low' for fast drafts, 'high' for final assets, 'xhigh' and 'max' for maximum detail at higher cost.
- **n** (integer): Number of images to generate (1-10).
- **output_format** (string): Output file format.
- **output_compression** (integer): Compression level for jpeg/webp (0-100). Ignored for png.
- **moderation** (string): Content moderation strictness. 'auto' applies standard filtering; 'low' is less restrictive.
- **background** (string): Background transparency. 'transparent' produces an alpha-channel image (requires png or webp output; prompt for an isolated subject, not a scene). 'opaque' forces a solid background. 'auto' lets the model decide.

#### Output
- **images** (array): The generated image files.

## other image apps

- [Gemini Nano Banana 2.1](https://inference.sh/apps/google/gemini-nano-banana-2-1.md): $1.50/M input, $0.0336–$0.1134/image (1K–4K), +$0.014/query Google Search
- [Grok Imagine Image 2.0](https://inference.sh/apps/xai/grok-imagine-image-2-0.md): $0.04/img low 1k, $0.06/img low 2k, $0.06/img med 1k, $0.08/img med 2k; $0.01/source img (edits)
- [GPT Image 2.5 Flare](https://inference.sh/apps/openai/gpt-image-2-5-flare.md): $0.006-$0.21/image at 1024x1024: low $0.0059, medium $0.0132, high $0.0527, xhigh $0.0937, max $0.2107. Larger sizes cost more; edits add ~$0.0083 per reference image.
- [Image Resize & Crop](https://inference.sh/apps/eval/resize.md): from $0.00000277/sec
- [X Post Card Renderer](https://inference.sh/apps/x/post-render.md): from $0.00000277/sec

## faq

### how much does GPT Image 2.5 Sunburst cost?

$0.006-$0.21 per 1024x1024 image: low $0.006, medium $0.013, high $0.053, xhigh $0.094, max $0.21. Larger sizes cost more; edits add ~$0.008 per reference image.. you pay per run from your inference shell credits. no subscription is required.

### how do I run GPT Image 2.5 Sunburst via api?

call openai/gpt-image-2-5-sunburst with the javascript or python sdk, the rest api, or `belt app run openai/gpt-image-2-5-sunburst` from a terminal. the api reference on this page lists every input.

### who makes GPT Image 2.5 Sunburst?

GPT Image 2.5 Sunburst is made by openai and runs on inference shell. every openai app is listed at https://inference.sh/apps/openai.

### can my agent use GPT Image 2.5 Sunburst?

yes. agents call it as a tool through the inference shell mcp server (https://api.inference.sh/mcp), the belt cli or the sdk, and pay per run like you do.

### what are the alternatives to GPT Image 2.5 Sunburst?

other image apps on inference shell include Gemini Nano Banana 2.1, Grok Imagine Image 2.0, GPT Image 2.5 Flare, Image Resize & Crop. they run through the same api, so switching is a one-line change.