[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [GPT Image 1 Mini Edit](https://spiral.ai/integrations/codex/gpt-image-1-mini-edit)

# How to Use GPT Image 1 Mini Edit in Codex

Revise an existing image using written instructions and image references. Choose it for changes to a scene or subject; the text-to-image version creates an image from a written brief.

|  |  |
| --- | --- |
| Model | GPT Image 1 Mini Edit |
| Available through | fal |
| Category | Image |
| Price | Up to $0.0676 per run at the default inputs. `quality`: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676. $0.0676 per unit of `num_images`. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GPT Image 1 Mini Edit in Codex

- Use GPT Image 1 Mini Edit on the project's current onboarding illustration. Change the backpack from red to forest green while preserving the character's face, pose, clothing, and framing. Save a new 1024 × 1024 PNG for review.
- Use GPT Image 1 Mini Edit on the project's landscape cover image. Replace the cloudy sky with a pale morning sky while preserving the buildings, camera angle, and foreground. Return a 1536 × 1024 PNG and inspect it for unintended changes.
- Remove the background from the photo I attach with GPT Image 1 Mini Edit and give me a transparent PNG. Save the result in ./assets.
- Use GPT Image 1 Mini Edit to clean up these product shots so they sit on pure white.
- Edit this image with GPT Image 1 Mini Edit: keep the subject, swap the background for a sunlit studio.

## How to set up GPT Image 1 Mini Edit in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 1 Mini 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": "fal-ai/gpt-image-1-mini/edit",
    "input": {
      "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: Codex finds GPT Image 1 Mini Edit on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## GPT Image 1 Mini Edit tools and prices

- [GPT Image 1 Mini · Edit](https://spiral.ai/tools/fal/fal-ai/gpt-image-1-mini/edit) (fal): Up to $0.0676 per run at the default inputs. `quality`: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676. Per unit of `num_images`: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size | auto, 1024x1024, 1536x1024, 1024x1536 | auto | Aspect ratio for the generated image |
| background | auto, transparent, opaque | auto | Background for the generated image |
| quality | auto, low, medium, high | auto | Quality for the generated image |
| num_images | 1 to 4 | 1 | Number of images to generate |
| output_format | jpeg, png, webp | png | Output format for the images |

## What can you do with GPT Image 1 Mini Edit in Codex?

Create image assets that fit the project you are building. Have the agent read the design brief, generate artwork at a supported size, and inspect it before adding it to the interface.

### Game asset concepts

Try a square inventory illustration of a single object with a transparent background. Review its silhouette at the size it will appear in the game.

### Editorial illustrations

Turn an article's main idea into a landscape illustration. Specify the subject and visual medium, and leave space for a headline added separately.

### Scene revisions

Use Edit to try a different object color or background in an existing image. State which details should stay, then check for unintended changes.

### Portrait artwork

Create a 1024 × 1536 illustration for a cover concept or poster. Keep exact typography as a separate design task.

### Visual direction studies

Describe the same subject in watercolor, paper collage, and pencil. Compare the results before choosing a direction for the finished artwork.

### Product image variations

Use a product image as an editing reference to explore a different setting. Inspect the product's shape and labels before accepting the result.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Codex guides](https://spiral.ai/integrations/codex)

## GPT Image 1 Mini Edit in other agents

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

## More Codex guides

- [GPT Image 1 Mini](https://spiral.ai/integrations/codex/gpt-image-1-mini)
- [GPT Image 1.5](https://spiral.ai/integrations/codex/gpt-image-1-5)
- [Finegrain Eraser Mask](https://spiral.ai/integrations/codex/finegrain-eraser-mask)
- [GPT Image 1.5 Edit](https://spiral.ai/integrations/codex/gpt-image-1-5-edit)
- [Finegrain Eraser Bbox](https://spiral.ai/integrations/codex/finegrain-eraser-bbox)
- [GPT Image 2](https://spiral.ai/integrations/codex/gpt-image-2)

## Questions about GPT Image 1 Mini Edit in Codex

**Can Codex use GPT Image 1 Mini Edit?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run GPT Image 1 Mini Edit like any built-in tool.

**How much does GPT Image 1 Mini Edit cost in Codex?**

Up to $0.0676 per run at the default inputs. `quality`: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676. $0.0676 per unit of `num_images`. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need a fal account to use GPT Image 1 Mini Edit in Codex?**

No. Spiral runs GPT Image 1 Mini 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 1 Mini Edit in Codex?**

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

**Does Codex wait while GPT Image 1 Mini Edit runs?**

GPT Image 1 Mini Edit runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.

**What is the difference between GPT Image 1 Mini and GPT Image 1 Mini Edit?**

The generation version creates a new image from a written prompt. Edit uses existing images as references alongside your instructions.

**What image sizes can it produce?**

Use 1024 × 1024 pixels for square images, 1536 × 1024 for landscape, or 1024 × 1536 for portrait.

**Can it make images with transparent backgrounds?**

Yes. Request a transparent background and save the result as PNG or WebP.

**Can I trust text inside the generated image?**

Check every word and its placement before using the image. For artwork that needs exact typography, consider generating the illustration first and adding the text in your design tool.

**Will a character look identical across several images?**

Separate generations can change a character's appearance or brand details. Try editing an approved reference, then compare each result against it.

