[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [FLUX.2 Max](https://spiral.ai/integrations/windsurf/flux-2-max)

# How to Use FLUX.2 Max in Windsurf

FLUX.2 Max creates product photos, posters, and editorial images from a written brief. Unlike FLUX.2 Max Edit, it starts from text alone.

|  |  |
| --- | --- |
| Model | FLUX.2 Max |
| Available through | fal |
| Category | Image |
| Price | $0.0911 for the first megapixel of each image, $0.039 for each further started megapixel of width × height. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with FLUX.2 Max in Windsurf

- Use FLUX.2 Max to create a 1536 × 1024 editorial image for the article in this project. Read its introduction, choose one concrete subject, and describe the lighting, lens, framing, and visible texture before generating.
- Use FLUX.2 Max to create a 1024 × 1024 poster for the event described in this project's content. Render the event title exactly, with large lettering at the top and a single illustrated subject below.
- Use FLUX.2 Max to create a 1024 × 1024 photographic concept for this project's coffee brand: a ceramic mug on oak, rising steam, side window light, an 85mm lens, and visible glaze texture.
- Generate a product photo with FLUX.2 Max: 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.2 Max.

## How to set up FLUX.2 Max in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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.2 Max**: 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-2-max",
    "input": {
      "prompt": "A lavish, baroque-style image of a powerful sorceress in her arcane study. She is dressed in robes of deep emerald velvet embroidered with gold thread and…"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds FLUX.2 Max on Spiral, shows the price and runs it.

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

## FLUX.2 Max tools and prices

- [FLUX.2 \[max\] · Text to Image](https://spiral.ai/tools/fal/fal-ai/flux-2-max) (fal): $0.0911 for the first megapixel of each image, $0.039 for each further started megapixel of width × height.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | landscape_4_3 | The size of the generated image. |
| seed |  | — | The seed to use for the generation. |
| safety_tolerance | 1, 2, 3, 4, 5 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. |
| output_format | jpeg, png | jpeg | The format of the generated image. |

## What can you do with FLUX.2 Max in Windsurf?

Produce product scenes, posters, and editorial images for your project with FLUX.2 Max. A coding agent can turn the project's copy and visual requirements into specific image instructions.

### Product photography from a brief

Use FLUX.2 Max to depict a proposed product with specific materials, lighting, and camera framing before arranging a physical shoot.

### Campaign posters

Use FLUX.2 Max to create a poster with a product scene, a short headline, and deliberately placed typography.

### Editorial photography concepts

Use FLUX.2 Max to explore portraits, landscapes, and documentary-style scenes with a specified lens, lighting, and texture.

### Magazine cover concepts

Use FLUX.2 Max to combine a cover image with a title and short cover lines, giving each text element a clear position and size.

## Overview

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

## FLUX.2 Max in other agents

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

## More Windsurf guides

- [FLUX.2 LoRA Edit](https://spiral.ai/integrations/windsurf/flux-2-lora-edit)
- [FLUX.2 Max Edit](https://spiral.ai/integrations/windsurf/flux-2-max-edit)
- [FLUX.2 LoRA](https://spiral.ai/integrations/windsurf/flux-2-lora)
- [FLUX.2 Realism LoRA](https://spiral.ai/integrations/windsurf/flux-2-realism-lora)
- [FLUX.2 Klein 9B LoRA](https://spiral.ai/integrations/windsurf/flux-2-klein-9b-lora)
- [FLUX.2 Satellite View Style](https://spiral.ai/integrations/windsurf/flux-2-satellite-view-style)

## Questions about FLUX.2 Max in Windsurf

**Can Windsurf use FLUX.2 Max?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run FLUX.2 Max like any built-in tool.

**How much does FLUX.2 Max cost in Windsurf?**

$0.0911 for the first megapixel of each image, $0.039 for each further started megapixel of width × height. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need a fal account to use FLUX.2 Max in Windsurf?**

No. Spiral runs FLUX.2 Max 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.2 Max in Windsurf?**

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

**Does Windsurf wait while FLUX.2 Max runs?**

FLUX.2 Max runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

**What is FLUX.2 Max good at?**

Product photography, editorial images, posters, and graphics with readable text are useful starting points. Describe the composition, lighting, materials, and wording you need.

**How large can FLUX.2 Max images be?**

Output can reach 4 megapixels, including 2048 × 2048. BFL recommends staying at or below 2 megapixels for quality and speed.

**How should I describe a photographic image?**

Specify the subject, lens, lighting, framing, and visible texture. A concrete description such as an 85mm portrait with side lighting gives clearer direction than asking for a professional photo.

**Does FLUX.2 Max support negative prompts?**

No. Describe the result positively: use "sharp focus" or "an empty street" to state what should appear.

**Can FLUX.2 Max put text inside an image?**

Yes, it supports readable typography for posters, ads, and magazine layouts. Give the exact wording and describe its position, size, and lettering style.

