Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · ImageReleased 2026-10-01

How to Use FLUX 3 Image Edit in Windsurf

FLUX 3 Image Edit is for targeted photo changes and compositions built from up to ten references. Unlike FLUX 3 Text to Image, it starts from supplied images, so you can describe what to change and what to keep.

Prompts to try with FLUX 3 Image Edit in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use FLUX 3 Image Edit on the product photo in this project's assets. Change the bottle cap to #214E34, preserve the label and bottle shape, and save a separate preview.

FLUX 3 Image EditWindsurf
Try asking
  • Use FLUX 3 Image Edit with the room photo and chair reference in this project. Place the chair beside the window, preserve the other furniture, and save the result for review.

  • Use FLUX 3 Image Edit on the poster asset. Replace the headline with "Autumn workshop" in the same location, preserve the illustration, and save a new image.

  • Use FLUX 3 Image Edit on the project's illustration. Restyle it as a two-color screen print while retaining the subject's proportions and composition.

  • Use FLUX 3 Image Edit on the homepage photo. Remove the mug at the lower right and its shadow, preserve the desk and laptop, and save a separate result.

How to set up FLUX 3 Image Edit 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:

    {
      "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.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run FLUX 3 Image Edit

    One request; the result comes back by polling or a webhook.

    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": "blackforestlabs/flux-3/edit-image",
        "input": {
          "prompt": "A red fox leaping over a stream in a pine forest, low-angle wildlife photograph.",
          "image_urls": [
            "<image_urls>"
          ]
        }
      }'

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

FLUX 3 Image Edit providers and prices

Spiral runs FLUX 3 Image Edit through fal. Open a card for today's price, with every fee included.

falImage
FLUX 3 Image Edit
blackforestlabs/flux-3/edit-image

Settings you can ask for

FLUX 3 Image Edit works from your prompt and image URLs. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Aspect ratioauto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4 and 7 moreauto

Output aspect ratio. Auto uses the first reference image when editing.

Resolution768sq, 1k, 1.5k, 2k, or 4k1k

Output resolution tier. 4k can take several minutes.

Enable prompt expansionon or offoff

Expand the prompt while preserving its intent and reference roles.

Safety tolerance0 to 42

Safety tolerance, from 0 (strictest) to 4.

Output formatjpeg or pngjpeg

The format of the generated image.

Every API field of FLUX 3 Image Edit is on its tool page: open its card above.

What can you do with FLUX 3 Image Edit in Windsurf?

Turn existing project artwork into revised visual assets with FLUX 3 Image Edit. Ask your coding agent to select the source images, write a precise edit, and save the result for review.

Product color previews

Recolor a product in an existing photo while asking to preserve its shape, label, and setting. Specify the target color with a hex code and check the match.

Product scene mockups

Combine a product reference with a setting reference to preview a new placement. Describe the product's position and how its lighting should fit the scene.

Outfit previews

Use a person photo and a garment reference to preview a clothing change. Name the pose and surrounding details you want to preserve.

Room furnishing concepts

Combine a room photo with furniture references to explore placement. State which object belongs where and which existing furnishings should stay.

Poster copy revisions

Revise words inside an existing poster. Quote the new copy and identify its location so the instruction targets the right text.

Object cleanup

Remove an unwanted object from an existing scene. Include its shadow or reflection in the removal request and inspect the surrounding area afterward.

Illustration restyling

Explore a different visual treatment for existing artwork. Describe the new medium and identify the shapes and composition to retain.

Packaging design previews

Combine a package photo with an artwork reference to preview a new surface design. Specify where the artwork belongs and which package details to preserve.

Questions about FLUX 3 Image Edit in Windsurf

Can Windsurf use FLUX 3 Image Edit?

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

How much does FLUX 3 Image Edit cost in Windsurf?

`resolution`: otherwise $0.0624, 1k (default) $0.1248, 1.5k $0.1872, 2k $0.312, 4k $1.0608 per megapixel. 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 3 Image Edit in Windsurf?

No. Spiral runs FLUX 3 Image 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 FLUX 3 Image Edit in Windsurf?

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

Does Windsurf wait while FLUX 3 Image Edit runs?

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

What is FLUX 3 Image Edit useful for?

Use it to change a specific detail, restyle an existing image, or combine references into a new composition. Start with an image that already contains the parts you want to keep.

How many reference images can I combine?

You can combine up to ten references. Give each one a clear job, such as the scene, product, garment, or visual style.

Will everything outside an edit stay unchanged?

Treat preservation as something to check. Even with targeted edits, nearby shadows, reflections, or lighting may change.

How large must reference images be?

Each reference must be at least 256 pixels on both sides. Oversized references are downscaled to at most four megapixels, so inspect small details in the result.

How do I change just one object?

Identify it by its appearance and location, then describe the replacement and the details to preserve. Bounding boxes can guide placement, but they do not create a hard clipping boundary.

Get started

Start using FLUX 3 Image Edit in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options