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

Gemini CLI · ImageReleased 2025-11-25

How to Use FLUX.2 Edit in Gemini CLI

Use FLUX.2 Edit to change existing images or combine visual references with written instructions. Unlike FLUX.2 LoRA Edit, it handles edits without a custom trained adapter.

Prompts to try with FLUX.2 Edit in Gemini CLI

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

Use FLUX.2 Edit on the product photograph in the project's assets. Place the product on a dark stone counter with soft window light from the right. Preserve its shape, label wording, and camera angle. Return a 1536 × 1024 image.

FLUX.2 EditGemini CLI
Try asking
  • Use FLUX.2 Edit to revise the project's onboarding illustration. Change the setting to a bright home office while preserving the person's pose, clothing, and position. Keep the result at 1024 × 1024.

  • Remove the background from the photo I attach with FLUX.2 Edit and give me a transparent PNG. Save the result in ./assets.

  • Use FLUX.2 Edit to clean up these product shots so they sit on pure white.

  • Edit this image with FLUX.2 Edit: keep the subject, swap the background for a sunlit studio.

How to set up FLUX.2 Edit in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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.2 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": "fal-ai/flux-2/edit",
        "input": {
          "prompt": "Change his clothes to casual suit and tie",
          "image_urls": [
            "<image_urls>"
          ]
        }
      }'

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

FLUX.2 Edit providers and prices

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

falImage

Settings you can ask for

FLUX.2 Edit works from your prompt and image URLs. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Guidance scale0 to 202.5

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.

Seeda whole number

The seed to use for the generation. If not provided, a random seed will be used.

Number of inference steps4 to 5028

The number of inference steps to perform.

Number of images1 to 41

The number of images to generate.

Accelerationnone, regular, or highregular

The acceleration level to use for the image generation.

Enable prompt expansionon or offoff

If set to true, the prompt will be expanded for better results.

Output formatjpeg, png, or webppng

The format of the generated image.

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

What can you do with FLUX.2 Edit in Gemini CLI?

Create product imagery and visual design concepts alongside the project you are building. Have the agent turn project requirements into concrete image briefs with explicit composition, colors, and text.

Product background changes

Start with a product image and request a new setting. Describe the product details to preserve and the lighting needed in the replacement scene.

Color studies from existing images

Recolor a garment, package, or piece of furniture in a supplied image. Name the object and provide its target hex color while asking to preserve its texture.

Illustrated treatments of photographs

Transform a supplied photograph into a specified illustration style. State which subjects, poses, and spatial relationships should remain recognizable.

Reference-based compositions

Combine a subject from one reference with an object or setting from another. Explain what each image contributes and how the elements should fit together.

Questions about FLUX.2 Edit in Gemini CLI

Can Gemini CLI use FLUX.2 Edit?

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

How much does FLUX.2 Edit cost in Gemini CLI?

Up to $0.078 per run at the default inputs. $0.0624 per unit of `num_images`. Each item in `image_urls` adds $0.0156. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need a fal account to use FLUX.2 Edit in Gemini CLI?

No. Spiral runs FLUX.2 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.2 Edit in Gemini CLI?

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

Does Gemini CLI wait while FLUX.2 Edit runs?

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

What is FLUX.2 good at?

FLUX.2 is useful for realistic product imagery, editorial scenes, and designs that include text. Specify the materials, lighting, composition, and exact wording you want.

How large can FLUX.2 images be?

These FLUX.2 tools support dimensions from 512 to 2048 pixels per side. A square image can reach 2048 × 2048 pixels, roughly four megapixels.

How should I write a FLUX.2 prompt?

Describe the subject, action, visual style, and setting. Use concrete details such as brushed steel, side lighting, or an overhead view.

Does FLUX.2 support negative prompts?

No. Describe the desired result positively: ask for an empty street or sharp focus instead of listing things to exclude.

How do I get readable text in FLUX.2 images?

Put the exact wording in quotation marks and describe its position and appearance. Black Forest Labs warns that text-bearing objects can produce gibberish when you leave their wording unspecified.

Get started

Start using FLUX.2 Edit in Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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