[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [GPT Image 2.5 Sunburst Edit](https://spiral.ai/integrations/claude-code/gpt-image-2-5-sunburst-edit)

# How to Use GPT Image 2.5 Sunburst Edit in Claude Code

GPT Image 2.5 Sunburst Edit revises existing images with close control over subjects and composition. Unlike GPT Image 2.5 Sunburst Text to Image, it uses reference images to guide changes.

|  |  |
| --- | --- |
| Model | GPT Image 2.5 Sunburst Edit |
| Available through | fal |
| Category | Image |
| Price | $0.0475 per 4:3 image at high quality ($0.00572 low, $0.0122 medium, $0.084 xhigh, $0.188 max). At high: $0.0605 square, $0.069 square HD, $0.0342 16:9. 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. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GPT Image 2.5 Sunburst Edit in Claude Code

- Use GPT Image 2.5 Sunburst Edit on the product image in public/assets. Change only the background to dark green painted wood; preserve the bottle shape, label wording, cap, and camera angle. Return a 1024 × 1024 image.
- Use GPT Image 2.5 Sunburst Edit on the existing article illustration. Replace the cloudy sky with pale morning light while preserving the buildings, people, framing, and ink texture. Return 1536 × 1024.
- Remove the background from the photo I attach with GPT Image 2.5 Sunburst Edit and give me a transparent PNG. Save the result in ./assets.
- Use GPT Image 2.5 Sunburst Edit to clean up these product shots so they sit on pure white.
- Edit this image with GPT Image 2.5 Sunburst Edit: keep the subject, swap the background for a sunlit studio.

## How to set up GPT Image 2.5 Sunburst Edit in Claude Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run GPT Image 2.5 Sunburst Edit**: One request; the result comes back by polling or a webhook.

```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": "fal",
    "model": "openai/gpt-image-2.5/sunburst/edit",
    "input": {
      "prompt": "Same workers, same beam, same lunch boxes - but they'\''re all on their phones now. One is taking a selfie. One is on a call looking annoyed. Same danger, new…",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: Claude Code finds GPT Image 2.5 Sunburst Edit on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## GPT Image 2.5 Sunburst Edit tools and prices

- [GPT Image 2.5 Sunburst · Image Editing](https://spiral.ai/tools/fal/openai/gpt-image-2.5/sunburst/edit) (fal): $0.0475 per 4:3 image at high quality ($0.00572 low, $0.0122 medium, $0.084 xhigh, $0.188 max). At high: $0.0605 square, $0.069 square HD, $0.0342 16:9. 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.
- [GPT Image 2.5 Sunburst · Edit](https://spiral.ai/tools/openai/gpt-image-2.5-sunburst/edit) (OpenAI): $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.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| mask_url |  | — | Mask image URL. Standard processing treats white as edit and black as keep. With image_passthrough or provider_options, supply an OpenAI-native PNG alpha mask: transparent regions are edited, and dimensions must match the first reference. Known provider issue: at non-square sizes the masked area can come back as a black box; square images and masks edit correctly. |
| image_size |  | auto | The size of the generated image. 'auto' infers it from the input images. Explicit sizes need both sides as multiples of 16, a longest edge of at most 3840 px, an aspect ratio of at most 3:1, and 655,360 to 8,294,400 pixels. |
| background | auto, transparent, opaque | auto | Background for the generated image |
| quality | auto, low, medium, high, xhigh, max | high | Quality for the generated image. Higher settings increase detail, latency, and token usage. Use 'auto' to let the model choose. |
| num_images | 1 to 10 | 1 | Number of images to generate |
| output_format | jpeg, png, webp | png | Output format for the images |

## What can you do with GPT Image 2.5 Sunburst Edit in Claude Code?

Turn project briefs into campaign artwork, illustrations, and product visuals. Use the project’s content and visual requirements to write specific briefs and review the resulting images.

### Campaign art

Develop campaign scenes with deliberate lighting, material detail, and space reserved for a headline.

### Product concepts

Explore packaging, surface finishes, and product presentation before arranging a photo shoot.

### Educational graphics

Develop illustrated process explanations with a defined reading order. Review labels and relationships before publication.

### Editorial illustrations

Explore gouache, ink, or print treatments for articles, covers, and presentation artwork.

### Product cutouts

Extract a supplied product onto a transparent background while asking to preserve its shape and label.

### Focused creative revisions

Change a background, garment, or product detail in an existing image while specifying what must remain intact.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## GPT Image 2.5 Sunburst Edit in other agents

- [Amp](https://spiral.ai/integrations/amp/gpt-image-2-5-sunburst-edit)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/gpt-image-2-5-sunburst-edit)
- [Claude](https://spiral.ai/integrations/claude-desktop/gpt-image-2-5-sunburst-edit)
- [Cline](https://spiral.ai/integrations/cline/gpt-image-2-5-sunburst-edit)
- [Codex](https://spiral.ai/integrations/codex/gpt-image-2-5-sunburst-edit)
- [Cursor](https://spiral.ai/integrations/cursor/gpt-image-2-5-sunburst-edit)
- [Devin](https://spiral.ai/integrations/devin/gpt-image-2-5-sunburst-edit)
- [dots](https://spiral.ai/integrations/dots/gpt-image-2-5-sunburst-edit)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/gpt-image-2-5-sunburst-edit)
- [Gemini](https://spiral.ai/integrations/gemini/gpt-image-2-5-sunburst-edit)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/gpt-image-2-5-sunburst-edit)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/gpt-image-2-5-sunburst-edit)
- [goose](https://spiral.ai/integrations/goose/gpt-image-2-5-sunburst-edit)
- [Grok](https://spiral.ai/integrations/grok/gpt-image-2-5-sunburst-edit)
- [Grok Build](https://spiral.ai/integrations/grok-build/gpt-image-2-5-sunburst-edit)
- [Hermes](https://spiral.ai/integrations/hermes/gpt-image-2-5-sunburst-edit)
- [Instinct](https://spiral.ai/integrations/instinct/gpt-image-2-5-sunburst-edit)
- [Manus](https://spiral.ai/integrations/manus/gpt-image-2-5-sunburst-edit)
- [Muse](https://spiral.ai/integrations/muse/gpt-image-2-5-sunburst-edit)
- [Muse Code](https://spiral.ai/integrations/muse-code/gpt-image-2-5-sunburst-edit)
- [n8n](https://spiral.ai/integrations/n8n/gpt-image-2-5-sunburst-edit)
- [Notion](https://spiral.ai/integrations/notion/gpt-image-2-5-sunburst-edit)
- [OpenClaw](https://spiral.ai/integrations/openclaw/gpt-image-2-5-sunburst-edit)
- [opencode](https://spiral.ai/integrations/opencode/gpt-image-2-5-sunburst-edit)
- [Perplexity](https://spiral.ai/integrations/perplexity/gpt-image-2-5-sunburst-edit)
- [Raycast](https://spiral.ai/integrations/raycast/gpt-image-2-5-sunburst-edit)
- [VS Code](https://spiral.ai/integrations/vscode/gpt-image-2-5-sunburst-edit)
- [Windsurf](https://spiral.ai/integrations/windsurf/gpt-image-2-5-sunburst-edit)
- [Zapier](https://spiral.ai/integrations/zapier/gpt-image-2-5-sunburst-edit)

## More Claude Code guides

- [GPT Image 2.5 Sunburst](https://spiral.ai/integrations/claude-code/gpt-image-2-5-sunburst)
- [GPT Image 2.5 Sunburst Text to Image](https://spiral.ai/integrations/claude-code/gpt-image-2-5-sunburst-text-to-image)
- [GPT Image 2.5 Flare Text to Image](https://spiral.ai/integrations/claude-code/gpt-image-2-5-flare-text-to-image)
- [GPT Image 2.6 Flare Edit](https://spiral.ai/integrations/claude-code/gpt-image-2-6-flare-edit)
- [GPT Image 2.5 Flare Edit](https://spiral.ai/integrations/claude-code/gpt-image-2-5-flare-edit)
- [GPT Image 2.6 Flare Text to Image](https://spiral.ai/integrations/claude-code/gpt-image-2-6-flare-text-to-image)

## Questions about GPT Image 2.5 Sunburst Edit in Claude Code

**Can Claude Code use GPT Image 2.5 Sunburst Edit?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run GPT Image 2.5 Sunburst Edit like any built-in tool.

**How much does GPT Image 2.5 Sunburst Edit cost in Claude Code?**

$0.0475 per 4:3 image at high quality ($0.00572 low, $0.0122 medium, $0.084 xhigh, $0.188 max). At high: $0.0605 square, $0.069 square HD, $0.0342 16:9. 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 from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need a fal account to use GPT Image 2.5 Sunburst Edit in Claude Code?**

No. Spiral runs GPT Image 2.5 Sunburst Edit on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GPT Image 2.5 Sunburst Edit in Claude Code?**

About two minutes: add the hosted server, then sign in.

**Does Claude Code wait while GPT Image 2.5 Sunburst Edit runs?**

GPT Image 2.5 Sunburst Edit runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

**What is GPT Image 2.5 Sunburst useful for?**

Use it for detailed campaign imagery, product concepts, illustrations, and information graphics. Its emphasis on visual detail makes it useful when materials, lighting, and composition matter.

**How large can the images be?**

Supported examples reach 3840 × 2160 pixels. Outputs above 2560 × 1440 are experimental, so inspect large images closely before using them.

**Can it put exact wording inside an image?**

Yes. Put the wording in quotes and specify its position and typography, then check the result against your requested copy.

**Can it make transparent assets?**

Yes. Request a transparent background and choose PNG or WebP so the output can retain transparency.

**Should I always choose the highest quality?**

Compare settings against the detail you need. A higher setting does not guarantee a better result for every prompt.

