How to Use FLUX.1 Kontext Max Multi in VS Code
FLUX.1 Kontext Max Multi combines image references for edits where lettering and detailed instructions matter. Compared with FLUX.1 Kontext Pro Multi, its underlying Max model emphasizes stronger prompt adherence, typography, and editing consistency.
Prompts to try with FLUX.1 Kontext Max Multi in VS Code
Copy an example into VS Code, or ask in your own words.
Use FLUX.1 Kontext Max 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 Max 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.
Use FLUX.1 Kontext Max 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.
Use FLUX.1 Kontext Max 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 Max 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.
How to set up FLUX.1 Kontext Max Multi in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - Sign in
VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.
Use the Spiral skill
- Send VS Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run FLUX.1 Kontext Max 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/max/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: VS Code finds FLUX.1 Kontext Max Multi on Spiral, shows the price and runs it.
FLUX.1 Kontext Max Multi providers and prices
Spiral runs FLUX.1 Kontext Max Multi through fal. Open a card for today's price, with every fee included.
$0.104 per image. Billed on num_images, default 1.
Settings you can ask for
FLUX.1 Kontext Max Multi works from your prompt and image URL. Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | a 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 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. |
| Number of images | 1 to 4 | 1 | The number of images to generate. |
| Output format | jpeg or png | jpeg | The format of the generated image. |
| Safety tolerance | 1 to 6 | 2 | The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. |
| Enhance prompt | on or off | off | Whether to enhance the prompt for better results. |
| Aspect ratio | 21: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 [max] · Editing (experimental Multi Image) is on its tool page: open its card above.
What can you do with FLUX.1 Kontext Max Multi in VS Code?
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.
More on FLUX.1 Kontext Max Multi and VS Code
Overview
FLUX.1 Kontext Max Multi in other agents
Questions about FLUX.1 Kontext Max Multi in VS Code
Can VS Code use FLUX.1 Kontext Max Multi?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run FLUX.1 Kontext Max Multi like any built-in tool.
How much does FLUX.1 Kontext Max Multi cost in VS Code?
$0.104 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 VS Code plan is separate.
Do I need a fal account to use FLUX.1 Kontext Max Multi in VS Code?
No. Spiral runs FLUX.1 Kontext Max 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 Max Multi in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while FLUX.1 Kontext Max Multi runs?
FLUX.1 Kontext Max Multi runs in the background. VS Code 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.
Start using FLUX.1 Kontext Max Multi in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


