[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [FLUX.1 Kontext Pro](https://spiral.ai/integrations/codex/flux-1-kontext-pro)

# How to Use FLUX.1 Kontext Pro in Codex

Use FLUX.1 Kontext Pro to recolor objects, change scenes, and carry a character through successive image edits. Choose it for iterative work; FLUX.1 Kontext Max puts more emphasis on typography and following detailed instructions.

|  |  |
| --- | --- |
| Model | FLUX.1 Kontext Pro |
| Available through | fal |
| Category | Image |
| Price | $0.052 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with FLUX.1 Kontext Pro in Codex

- Use FLUX.1 Kontext Pro to edit the ceramic mug photograph in the project's assets. Change only the mug's body to dark green while preserving its handle shape, surface texture, lighting, and background.
- Generate a product photo with FLUX.1 Kontext Pro: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
- Make four logo concepts for a coffee brand called "Northline" with FLUX.1 Kontext Pro.
- Create a 16:9 hero image of a quiet mountain cabin at dusk with FLUX.1 Kontext Pro.
- Generate a 9:16 poster with FLUX.1 Kontext Pro for a jazz night called "Blue Hour", deep navy and brass tones.

## How to set up FLUX.1 Kontext Pro 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 FLUX.1 Kontext Pro**: 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/flux-pro/kontext",
    "input": {
      "prompt": "Put a donut next to the flour.",
      "image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png"
    }
  }'
```

Then paste one of the prompts above: Codex finds FLUX.1 Kontext Pro on Spiral, shows the price and runs it.

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

## FLUX.1 Kontext Pro tools and prices

- [FLUX.1 Kontext \[pro\] · Editing](https://spiral.ai/tools/fal/fal-ai/flux-pro/kontext) (fal): $0.052 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| guidance_scale | 1 to 20 | 3.5 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |
| num_images | 1 to 4 | 1 | The number of images to generate. |
| output_format | jpeg, png | jpeg | The format of the generated image. |
| safety_tolerance | 1, 2, 3, 4, 5, 6 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. |
| enhance_prompt |  | false | Whether to enhance the prompt for better results. |

## What can you do with FLUX.1 Kontext Pro in Codex?

Turn project briefs into illustrations, product concepts, and other image assets with FLUX.1 Kontext. A coding agent can use the project's content to write specific visual requests and compare results with the intended design.

### Product color studies

Start with a product image and change one object's color. Specify the shape, material, lighting, and background that should remain.

### Campaign scene changes

Move a photographed subject into a different setting while asking to preserve its appearance. Compare important details with the original.

### Sign and label revisions

Replace wording in an existing sign, poster, or label while retaining its surrounding design. Check spelling and placement in the result.

### Character storyboard frames

Use a character reference to develop scenes for a storyboard. Request preservation of facial features, hairstyle, and clothing, then inspect continuity between frames.

## Overview

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

## FLUX.1 Kontext Pro in other agents

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

## More Codex guides

- [FLUX.1 Kontext Max Text to Image](https://spiral.ai/integrations/codex/flux-1-kontext-max-text-to-image)
- [FLUX.1 Kontext Pro Multi](https://spiral.ai/integrations/codex/flux-1-kontext-pro-multi)
- [FLUX.1 Kontext Max Multi](https://spiral.ai/integrations/codex/flux-1-kontext-max-multi)
- [FLUX.1 Kontext Pro Text to Image](https://spiral.ai/integrations/codex/flux-1-kontext-pro-text-to-image)
- [FLUX.1 Kontext Max](https://spiral.ai/integrations/codex/flux-1-kontext-max)
- [FLUX.1 Krea Dev](https://spiral.ai/integrations/codex/flux-1-krea-dev)

## Questions about FLUX.1 Kontext Pro in Codex

**Can Codex use FLUX.1 Kontext Pro?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run FLUX.1 Kontext Pro like any built-in tool.

**How much does FLUX.1 Kontext Pro cost in Codex?**

$0.052 per image. Billed on `num_images`, default 1. 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 FLUX.1 Kontext Pro in Codex?**

No. Spiral runs FLUX.1 Kontext Pro on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up FLUX.1 Kontext Pro in Codex?**

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

**Does Codex wait while FLUX.1 Kontext Pro runs?**

FLUX.1 Kontext Pro runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.

**When should I choose Pro or Max?**

Choose Pro for iterative visual work and a balance of speed and quality. Choose Max when typography and following detailed instructions carry more weight.

**What resolution does FLUX.1 Kontext produce?**

Outputs are approximately 1 megapixel. A square text-to-image result defaults to 1024 by 1024 pixels; a wider or taller shape changes the dimensions within roughly that pixel budget.

**Can FLUX.1 Kontext make illustrations as well as realistic images?**

Yes. Describe the intended medium, such as a photograph, pencil illustration, or painting, along with the subject and composition.

**Can I rely on every word in an image being correct?**

Review the result before using it. Max emphasizes typography, but FLUX.1 Kontext can still miss specific instructions.

**What should I include in a visual brief?**

Name the subject, setting, visual style, lighting, and composition you want. Make requirements concrete, such as a red ceramic cup on a wooden table beside a window.

