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

Gemini CLI · ImageReleased 2026-09-08

How to Use GPT Image 2.5 Flare Edit in Gemini CLI

GPT Image 2.5 Flare Edit changes existing images while working to preserve subjects, composition, and visual style. Unlike GPT Image 2.5 Flare Text to Image, it starts from reference images for product edits, scene changes, and restyling.

Prompts to try with GPT Image 2.5 Flare Edit in Gemini CLI

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

Use GPT Image 2.5 Flare Edit to revise the product photo in our assets folder. Replace only the background with pale stone; preserve the bottle shape, label, framing, and light direction. Return a 1024 × 1024 image.

GPT Image 2.5 Flare EditGemini CLI
Try asking
  • Use GPT Image 2.5 Flare Edit on the existing onboarding illustration. Change only the orange objects to the project's green accent, preserving shapes and composition. Return a 1536 × 1024 PNG.

  • Remove the background from the photo I attach with GPT Image 2.5 Flare Edit and give me a transparent PNG. Save the result in ./assets.

  • Use GPT Image 2.5 Flare Edit to clean up these product shots so they sit on pure white.

  • Edit this image with GPT Image 2.5 Flare Edit: keep the subject, swap the background for a sunlit studio.

How to set up GPT Image 2.5 Flare 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 GPT Image 2.5 Flare 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": "openai/gpt-image-2.5/flare/edit",
        "input": {
          "prompt": "Same workers, same beam, same lunch boxes - but they'\''re all on their phones now. One is taking a selfie. One is on a call looking annoyed. Same danger, new…",
          "image_urls": [
            "<image_urls>"
          ]
        }
      }'

Then paste one of the prompts above: Gemini CLI finds GPT Image 2.5 Flare Edit on Spiral, shows the price and runs it.

GPT Image 2.5 Flare Edit providers and prices

Spiral runs GPT Image 2.5 Flare Edit through fal and OpenAI. Open a card for today's price, with every fee included. Name one in your prompt, or let Gemini CLI pick.

falImage
GPT Image 2.5 Flare · Image Editing
openai/gpt-image-2.5/flare/edit
OpenAIImage
GPT Image 2.5 Flare · Edit
gpt-image-2.5-flare/edit

Settings you can ask for

GPT Image 2.5 Flare Edit works from your prompt, image URLs, and mask URL. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Backgroundauto, transparent, or opaqueauto

Background for the generated image

Qualityauto, low, medium, high, xhigh, or maxhigh

Quality for the generated image. Higher settings increase detail, latency, and token usage. Use 'auto' to let the model choose.

Number of images1 to 101

Number of images to generate

Output formatjpeg, png, or webppng

Output format for the images

Output compression0 to 100

Compression level from 0 to 100. Only supported when output_format is 'jpeg' or 'webp'.

Image passthroughon or offoff

Send reference images and masks without resizing or re-encoding, and return the provider's original image bytes and format. Requests use the direct OpenAI API. Masks must be PNGs with an alpha channel: transparent regions are edited, and dimensions must match the first reference.

Every API field of GPT Image 2.5 Flare · Image Editing is on its tool page: open its card above.

What can you do with GPT Image 2.5 Flare Edit in Gemini CLI?

Turn project requirements into image assets and screen previews with GPT Image 2.5 Flare. A coding agent can use the project's design guidance to write briefs and check the resulting assets against their intended placement.

Social campaign visuals

Create a campaign scene from a written brief, or adapt an existing campaign image while preserving its main subject.

Editorial illustrations

Illustrate an article concept from text, or restyle an existing illustration with a specified palette and medium.

Interface previews

Explore screen layouts from a description, or revise an existing screen image. Review text and alignment before implementing the design.

Product scene concepts

Visualize a proposed product from a written description, or place an existing product image in a different setting.

Product background changes

Replace a product photo's setting while asking to preserve its shape, label, and camera angle.

Interior material previews

Change upholstery or finishes in an existing room photo, one change at a time, while retaining furniture placement.

Lighting studies

Compare daylight and evening treatments of an existing scene while asking to retain its objects and framing.

Reference-based restyling

Reinterpret a supplied subject in a different visual medium while checking that its identifying features remain recognizable.

GPT Image 2.5 Flare Edit success rate and speed on Spiral

Success and speed over the last 24 hours, across every run of these tools on Spiral.

Success rate
95.5%
Fastest median run time
29.2s
Runs, last 24 hours
67
ToolSuccessMedian timeRuns
GPT Image 2.5 Flare · Image Editing95.0%29.2s60
GPT Image 2.5 Flare · EditNot enough runs

Questions about GPT Image 2.5 Flare Edit in Gemini CLI

Can Gemini CLI use GPT Image 2.5 Flare Edit?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run GPT Image 2.5 Flare Edit like any built-in tool.

How much does GPT Image 2.5 Flare Edit cost in Gemini CLI?

$0.0475 per 4:3 image at high quality ($0.00572 low, $0.0122 medium, $0.084 xhigh, $0.188 max). At high: $0.0605 square, $0.069 square HD, $0.0342 16:9. Auto quality or size: the price of the one chosen for the request. Prompt: $6.50 per 1M tokens. Input images: $0.0106 each at 1024×1024. 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 GPT Image 2.5 Flare Edit in Gemini CLI?

No. Spiral runs GPT Image 2.5 Flare 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 GPT Image 2.5 Flare Edit in Gemini CLI?

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

Does Gemini CLI wait while GPT Image 2.5 Flare Edit runs?

GPT Image 2.5 Flare Edit runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

What is GPT Image 2.5 Flare good at?

Flare suits visual drafts for social content, product experiences, and image prototyping. Its strengths include natural lighting, textures, and following a defined visual style.

How large can GPT Image 2.5 Flare images be?

The longest edge can reach 3840 pixels, including 3840 × 2160 output. Dimensions must be multiples of 16, stay within a 3:1 aspect ratio, and total 655360 to 8294400 pixels; output above 2560 × 1440 is experimental.

Can GPT Image 2.5 Flare render readable text?

Yes, but exact placement and clarity can still fail. Put required wording in quotes, specify where it belongs, request no additional text, and check the result.

Can GPT Image 2.5 Flare create transparent images?

Yes. Request a transparent background with PNG or WebP output, then inspect edges and transparent areas before using the asset.

Does higher quality always improve GPT Image 2.5 Flare results?

No. Start with low quality for drafts, then compare higher settings against the specific detail or text problem you need to fix.

Get started

Start using GPT Image 2.5 Flare 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