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

VS Code · ImageReleased 2025-05-29

How to Use FLUX.1 Kontext Max in VS Code

Use FLUX.1 Kontext Max for image edits where wording, typography, and consistency need closer attention. Compared with FLUX.1 Kontext Pro, it emphasizes following detailed instructions and rendering text.

Prompts to try with FLUX.1 Kontext Max in VS Code

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

Use FLUX.1 Kontext Max to edit the storefront image in the project's assets. Replace 'COMING SOON' with 'NOW OPEN' while preserving the sign's position, lettering style, and surrounding facade.

FLUX.1 Kontext MaxVS Code
Try asking
  • Generate a product photo with FLUX.1 Kontext 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.1 Kontext Max.

  • Create a 16:9 hero image of a quiet mountain cabin at dusk with FLUX.1 Kontext Max.

  • Generate a 9:16 poster with FLUX.1 Kontext Max for a jazz night called "Blue Hour", deep navy and brass tones.

How to set up FLUX.1 Kontext Max in VS Code

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

Use Spiral's MCP server

  1. 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"}'
  2. 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

  1. Send VS Code 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 Max

    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",
        "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: VS Code finds FLUX.1 Kontext Max on Spiral, shows the price and runs it.

FLUX.1 Kontext Max providers and prices

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

falImage
FLUX.1 Kontext [max] · Editing
fal-ai/flux-pro/kontext/max

Settings you can ask for

FLUX.1 Kontext Max works from your prompt and image URL. Ask VS Code 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 [max] · Editing is on its tool page: open its card above.

What can you do with FLUX.1 Kontext Max in VS Code?

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.

Questions about FLUX.1 Kontext Max in VS Code

Can VS Code use FLUX.1 Kontext Max?

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

How much does FLUX.1 Kontext Max 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 in VS Code?

No. Spiral runs FLUX.1 Kontext 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.1 Kontext Max in VS Code?

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

Does VS Code wait while FLUX.1 Kontext Max runs?

FLUX.1 Kontext Max runs in the background. VS Code 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.

Get started

Start using FLUX.1 Kontext Max 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 VS Code

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