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

Gemini CLI · ImageReleased 2026-08-11

How to Use Topaz Upscale Precision in Gemini CLI

Topaz Upscale Precision enlarges existing photos and graphics up to 4x while preserving their appearance. Start with Standard V2 for everyday photos or High Fidelity V3 for clean originals where texture matters.

Prompts to try with Topaz Upscale Precision in Gemini CLI

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

Use Topaz Upscale Precision with Standard V2 to enlarge the product photos in public/products to 2x. Write separate outputs and build a comparison page focused on labels and surface detail.

Topaz Upscale PrecisionGemini CLI
Try asking
  • Use Topaz Upscale Precision with High Fidelity V3 to enlarge the clean photographs in assets/editorial to 2x. Keep the originals and prepare comparisons of fine texture.

  • Use Topaz Upscale Precision with Low Resolution V2 on the small, compressed images in assets/archive at 2x. Create a review sheet showing each source beside its result.

  • Use Topaz Upscale Precision with Text Refine to enlarge the graphics in docs/images to 2x. Prepare comparisons so I can check every letter and geometric edge.

  • Use Topaz Upscale Precision with CGI to enlarge the illustrations in assets/art to 4x. Save separate outputs and show comparisons of line work and flat colors.

How to set up Topaz Upscale Precision 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 Upscale Precision

    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/precision",
        "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 Upscale Precision on Spiral, shows the price and runs it.

Topaz Upscale Precision providers and prices

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

falImage
Topaz Upscale · Precision Image Upscaling
topaz/upscale/image/precision

Settings you can ask for

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

SettingAllowed valuesDefaultDescription
ModelStandard V2, High Fidelity V3, High Fidelity V2, Low Resolution V2, CGI, Text Refine, or FacesStandard V2

Precision upscaling model. Standard V2 fits most photos; High Fidelity V3/V2 preserve detail in professional shots; Low Resolution V2 recovers compressed sources; CGI targets art and rendered graphics; Text Refine keeps text and shapes crisp; Faces restores facial detail with Face Recovery 3.

Upscale factor1 to 42

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

Crop to fillon or offoff
Output formatjpeg or pngjpeg

Output format of the upscaled image.

Subject detectionAll, Foreground, or BackgroundAll

Subject detection mode for the image enhancement.

Face enhancementon or offon

Whether to apply face enhancement to the image.

Face enhancement creativity0 to 10

Creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled.

Face enhancement strength0 to 10.8

Strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled.

Sharpen0 to 1

Sharpening level (0.0-1.0). Default varies by model.

Denoise0 to 1

Denoising level (0.0-1.0). Default varies by model.

Fix compression0 to 1

Compression artifact removal level (0.0-1.0). Not supported by the CGI model.

Strength0.01 to 1

Enhancement strength (0.01-1.0). Applies to Text Refine model only.

Every API field of Topaz Upscale · Precision Image Upscaling is on its tool page: open its card above.

What can you do with Topaz Upscale Precision in Gemini CLI?

Prepare larger versions of a project's existing photos, illustrations, and graphics. Have the coding agent select processing by image content and create comparisons for review.

Product listing enlargements

Enlarge existing product photos with Standard V2. Compare labels, seams, and surface textures with the originals before using the results in a catalog.

Photography for print

Use High Fidelity V3 to enlarge clean camera originals for prints. Inspect skin, foliage, and other fine textures before approving the result.

Older web images

Try Low Resolution V2 on small, compressed images being reused in an article or presentation. Review recovered detail against the source.

Graphics with lettering

Enlarge existing graphics with Text Refine when letters and geometric edges need attention. Check every word against the original before publishing.

Illustrations for larger layouts

Use CGI to enlarge existing illustrations while keeping line work and flat color areas consistent with the source.

Larger render stills

Enlarge existing CGI renders for presentations or display graphics. Check contours and flat surfaces for changes before accepting the output.

Portrait restoration

Try Faces on portraits with degraded facial detail. Keep the original beside the result and review facial features before sharing.

Topaz Upscale Precision success rate and speed on Spiral

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

Success rate
100.0%
Fastest median run time
24.7s
Runs, last 24 hours
159
ToolSuccessMedian timeRuns
Topaz Upscale · Precision Image Upscaling100.0%24.7s159

Questions about Topaz Upscale Precision in Gemini CLI

Can Gemini CLI use Topaz Upscale Precision?

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

How much does Topaz Upscale Precision cost in Gemini CLI?

$0.104 per started 24 megapixels of output. Output is the input size × the upscale factor squared. 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 Upscale Precision in Gemini CLI?

No. Spiral runs Topaz Upscale Precision 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 Upscale Precision in Gemini CLI?

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

Does Gemini CLI wait while Topaz Upscale Precision runs?

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

What is Topaz Upscale Precision best for?

Enlarging existing photos and graphics when their original appearance matters. Precision processing prioritizes source detail, so it is a better fit for faithful enlargement than rebuilding missing content.

Should I choose Standard V2 or High Fidelity V3?

Start with Standard V2 for everyday photos and mixed graphics. Try High Fidelity V3 on clean originals where fine texture matters; Topaz reports less detail loss and artifacting than High Fidelity V2.

What should I use for small or compressed images?

Try Low Resolution V2 for sources with small dimensions, limited detail, or heavy compression. Compare the result with the original before accepting reconstructed detail.

Can Topaz Upscale Precision enlarge text and illustrations?

Use Text Refine when lettering and geometric shapes are the priority. Choose CGI for illustrations and renders where clean lines and flat colors matter.

How large can Topaz Upscale Precision make an image?

Photo and graphics upscaling supports enlargement up to 4x. Topaz also documents a 256 MP input and output cap for most Precision models, so check the intended output dimensions before enlarging a large original.

Get started

Start using Topaz Upscale Precision 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