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

Windsurf · Image

How to Use FLUX.1 Kontext Pro Multi in Windsurf

FLUX.1 Kontext Pro Multi combines image references for composition drafts, object changes, and scene edits. Choose it for iterative visual work; FLUX.1 Kontext Max Multi places more emphasis on typography and detailed instruction following.

Prompts to try with FLUX.1 Kontext Pro Multi in Windsurf

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

Use FLUX.1 Kontext Pro Multi with the product photo and kitchen reference in this project's assets. Place the product on the kitchen counter, preserving its shape, color, and label. Save the result beside the originals for review.

FLUX.1 Kontext Pro MultiWindsurf
Try asking
  • Use FLUX.1 Kontext Pro Multi with the project's mascot reference and park image. Show the mascot sitting on a park bench, retaining its face, outfit, and proportions. Save the concept in the design assets folder.

  • Use FLUX.1 Kontext Pro Multi to edit the mug photo in this project's assets. Change only the mug's body to dark green, preserving its handle, shape, and surrounding scene. Save the result without replacing the source.

  • Use FLUX.1 Kontext Pro Multi to edit the campaign poster in this project. Replace 'Summer market' with 'Autumn market', preserving the lettering style, illustration, and layout. Save a separate edited image.

  • Use FLUX.1 Kontext Pro Multi with the project's approved illustration as a style reference. Create a scene of a bicycle outside a neighborhood bakery using the same visual treatment. Save it as a new asset for review.

How to set up FLUX.1 Kontext Pro Multi 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.1 Kontext Pro Multi

    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": "fal-ai/flux-pro/kontext/multi",
        "input": {
          "prompt": "Put the little duckling on top of the woman'\''s t-shirt.",
          "image_urls": [
            "<image_urls>"
          ]
        }
      }'

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

FLUX.1 Kontext Pro Multi providers and prices

Spiral runs FLUX.1 Kontext Pro Multi through fal. Open a card for today's price, with every fee included.

falImage

Settings you can ask for

FLUX.1 Kontext Pro Multi works from your prompt and image URL. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number

The same seed and the same prompt given to the same version of the model

will output the same image every time.

Guidance scale (CFG)1 to 203.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.

Number of images1 to 41

The number of images to generate.

Output formatjpeg or pngjpeg

The format of the generated image.

Safety tolerance1 to 62

The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.

Enhance prompton or offoff

Whether to enhance the prompt for better results.

Aspect ratio21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 and 1 more

The aspect ratio of the generated image.

Every API field of FLUX.1 Kontext [pro] · Editing (experimental Multi Image) is on its tool page: open its card above.

What can you do with FLUX.1 Kontext Pro Multi in Windsurf?

Turn project image assets into edited product scenes, character concepts, and revised promotional artwork with FLUX.1 Kontext Multi. A coding agent can use the project's visual references and save the results beside the source assets for comparison.

Product scene drafts

Combine a product photo with a setting reference to draft a new promotional image. Ask to preserve the product's shape, color, and label, then check those details against the source.

Poster lettering updates

Replace a short headline in existing artwork without requesting a complete redesign. Quote the old and new wording and specify which surrounding elements should stay.

Character storyboards

Use a character reference to draft scenes in different environments. Preserve distinctive facial features, clothing, and proportions, and review consistency between scenes.

Illustration style studies

Use an approved illustration as a style reference for a new scene. Describe the intended subject and compare how well the result retains the reference's visual treatment.

Object color studies

Recolor a specific object in an existing image to explore design directions. Name the object precisely and ask to preserve its shape and the surrounding scene.

Background replacement concepts

Move a referenced person or object into a different setting for campaign planning. Specify the subject details to preserve and review unintended changes before using the image.

Illustrated merchandise mockups

Combine an illustration reference with a garment photo to explore a printed design. Describe the design's placement and ask to preserve the garment's shape and existing scene.

Questions about FLUX.1 Kontext Pro Multi in Windsurf

Can Windsurf use FLUX.1 Kontext Pro Multi?

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

How much does FLUX.1 Kontext Pro Multi cost in Windsurf?

$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 Windsurf plan is separate.

Do I need a fal account to use FLUX.1 Kontext Pro Multi in Windsurf?

No. Spiral runs FLUX.1 Kontext Pro Multi 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 Multi in Windsurf?

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

Does Windsurf wait while FLUX.1 Kontext Pro Multi runs?

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

What is FLUX.1 Kontext Multi useful for?

Use it to combine image references, change objects, replace lettering, or move a recognizable character into another scene. Both Pro Multi and Max Multi are labeled experimental.

How do Pro Multi and Max Multi differ?

Both handle multiple image references. Black Forest Labs positions the underlying Max model around stronger instruction following, typography, and editing consistency, making it worth comparing on lettering or detailed edits.

Can FLUX.1 Kontext Multi keep a character recognizable?

Kontext supports preserving character identity and distinctive features across scenes. Name the features that matter in your edit request, then compare the result against the original reference.

How should I request a text replacement?

Quote both versions: "Replace 'Summer market' with 'Autumn market'." Add a separate instruction to preserve the lettering style and surrounding artwork.

Can FLUX.1 Kontext Multi reuse an illustration's style?

Kontext supports generating new scenes from a style reference. Describe the new subject and identify which reference supplies the visual treatment.

Get started

Start using FLUX.1 Kontext Pro Multi 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