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

Gemini CLI · Image

How to Use Topaz Bloom 2 in Gemini CLI

Topaz Bloom 2 enlarges AI artwork, illustrations, and CG renders while adding new texture and detail. Compared with Bloom, it reduces anatomical errors such as extra fingers, though stronger creativity can still introduce artifacts.

Prompts to try with Topaz Bloom 2 in Gemini CLI

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

Use Topaz Bloom 2 to upscale the AI illustration in public/images/hero.png by 2x with creativity 2 and color preservation enabled. Save a separate candidate and build a side-by-side comparison with the original.

Topaz Bloom 2Gemini CLI
Try asking
  • Use Topaz Bloom 2 on the CG environment render in assets/concept/environment.png at 2x enlargement and creativity 3. Keep the original and add a zoomable comparison page for reviewing the generated surface detail.

  • Use Topaz Bloom 2 to make two 2x enlargements of assets/art/cover.png, using creativity 2 and 6. Label both results and show them beside the source so I can choose the amount of reinterpretation.

  • Use Topaz Bloom 2 on the AI character illustration in assets/characters/explorer.png at 2x enlargement and creativity 2. Create a review view with close-ups of the face, hands, and body proportions.

  • Use Topaz Bloom 2 to enlarge the generated campaign illustration in public/images/campaign.png by 2x with color preservation enabled and creativity 2. Add an original-versus-output toggle to the asset preview.

How to set up Topaz Bloom 2 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 Topaz Bloom 2

    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": "topaz/upscale/image/creative",
        "input": {
          "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg"
        }
      }'

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

Topaz Bloom 2 providers and prices

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

falImage

Settings you can ask for

Topaz Bloom 2 works from your image URL. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
ModelBloom 2, Bloom, or Bloom RealismBloom 2

Creative (Bloom) upscaling model. Bloom 2 is the latest and most capable; Bloom creatively upscales and transforms AI-generated images; Bloom Realism biases the added detail toward photorealism.

Upscale factor1 to 42

Factor to upscale the image by (e.g. 2.0 doubles width and height)

Autoprompton or off

Enable automatic prompt generation. Applies to Bloom 2 only; Topaz defaults it to true when omitted.

Creativity1 to 9

Creativity level (1-9). Higher values produce more creative/hallucinated details. Applies to Bloom 2 only.

Color preservationon or off

Preserve the source image's colors in the output. Applies to Bloom 2 only.

Crop to fillon or offoff
Output formatjpeg or pngjpeg

Output format of the upscaled image.

Every API field of Topaz Upscale Image Creative · Upscale Image Creative ( Bloom 2 ) is on its tool page: open its card above.

What can you do with Topaz Bloom 2 in Gemini CLI?

Turn existing AI illustrations and CG renders into larger assets for a project with Topaz Bloom 2. A coding agent can prepare candidate outputs and a comparison view so you can review texture, color, and anatomy before replacing an asset.

Enlarge illustrated website artwork

Use Topaz Bloom 2 on an existing AI illustration intended for a website hero. Start with low creativity and compare the added textures with the approved artwork.

Prepare generated art for print review

Enlarge AI artwork with Topaz Bloom 2 for a poster or art print proof. Inspect the generated detail at full size before approving the print.

Develop CG presentation images

Apply Topaz Bloom 2 to a CG render when additional surface texture is welcome. Compare the result with the render before using it in a presentation.

Explore concept art treatments

Run an existing concept image through Topaz Bloom 2 at different creativity levels. Use the results to choose how much reinterpretation suits the art direction.

Enlarge generated character illustrations

Use Topaz Bloom 2 to add detail to AI character artwork for a pitch deck or character sheet. Review hands, faces, and proportions before selecting an output.

Add detail while retaining an approved palette

Process an existing campaign illustration with Topaz Bloom 2 and color preservation enabled. Review the new textures alongside the original palette.

Questions about Topaz Bloom 2 in Gemini CLI

Can Gemini CLI use Topaz Bloom 2?

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

How much does Topaz Bloom 2 cost in Gemini CLI?

Up to $0.104 per run at the default inputs. 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 Topaz Bloom 2 in Gemini CLI?

No. Spiral runs Topaz Bloom 2 on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Topaz Bloom 2 in Gemini CLI?

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

Does Gemini CLI wait while Topaz Bloom 2 runs?

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

What images is Topaz Bloom 2 best suited for?

Start with AI-generated artwork, illustrations, or CG renders that would benefit from added texture and detail. It suits projects where some creative interpretation is welcome.

Does Topaz Bloom 2 recover the original missing detail?

Treat added detail as generated interpretation. For work that requires exact source fidelity, creative upscaling is a poor fit.

How should I choose the creativity level?

Start low when the composition and subject already work. Raise creativity when you want more reinterpretation, then inspect the result for invented details and artifacts.

Can Topaz Bloom 2 keep the original colors?

Use color preservation when the source palette matters. Compare the result with the original before accepting it.

Can Topaz Bloom 2 still distort hands or anatomy?

Yes. Topaz reports fewer anatomical artifacts than earlier creative upscaling, but higher creativity still increases artifact risk; check hands and body proportions before using the output.

Get started

Start using Topaz Bloom 2 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