How to Use Clarity Upscaler in Gemini CLI
Clarity Upscaler enlarges existing images with detail you can steer through a descriptive prompt. Adjust creativity and resemblance to balance new texture against keeping the original appearance.
Prompts to try with Clarity Upscaler in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Clarity Upscaler to enlarge the homepage illustration in this project 2x. Describe its existing subject and style, use low creativity and high resemblance, and save a separate output for review.
Use Clarity Upscaler on the landscape artwork in the project's image assets. Make two 2x enlargements with the same seed: one with low creativity and one with moderate creativity. Build a side-by-side preview.
Use Clarity Upscaler to make a 2x enlargement of the product mockup used on the landing page. Describe its materials and lighting, favor resemblance, and keep the current asset until I review the result.
Use Clarity Upscaler on the character concept image in this project. Enlarge it 2x with a prompt describing the visible costume materials, then prepare close-up comparisons of the face and clothing.
Use Clarity Upscaler to enlarge the article illustration in this repository 2x. Keep the source and prompt fixed while testing two resemblance settings, and show both results beside the original.
How to set up Clarity Upscaler in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Clarity Upscaler
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/clarity-upscaler", "input": { "image_url": "https://storage.googleapis.com/falserverless/gallery/NOCA_Mick-Thompson.resized.resized.jpg" } }'
Then paste one of the prompts above: Gemini CLI finds Clarity Upscaler on Spiral, shows the price and runs it.
Clarity Upscaler providers and prices
Spiral runs Clarity Upscaler through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Clarity Upscaler works from your image URL and prompt. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Upscale factor | 1 to 4 | 2 | The upscale factor |
| Negative prompt | what to leave out, in words | (worst quality, low quality, normal quality:2) | The negative prompt to use. Use it to address details that you don't want in the image. |
| Creativity | 0 to 1 | 0.35 | The creativity of the model. The higher the creativity, the more the model will deviate from the prompt. Refers to the denoise strength of the sampling. |
| Resemblance | 0 to 1 | 0.6 | The resemblance of the upscaled image to the original image. The higher the resemblance, the more the model will try to keep the original image. Refers to the strength of the ControlNet. |
| Guidance scale (CFG) | 0 to 20 | 4 | 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 inference steps | 4 to 50 | 18 | The number of inference steps to perform. |
| Seed | a whole number from 0 | The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. |
Every API field of Clarity Upscaler is on its tool page: open its card above.
What can you do with Clarity Upscaler in Gemini CLI?
Turn existing project artwork into larger images for websites and apps with Clarity Upscaler. Your coding agent can prepare comparisons and keep the originals available for review.
Website artwork
Enlarge an existing website illustration for a larger placement. Describe its current style and review the result against the original before replacing it.
Editorial illustrations
Prepare a larger version of an illustration for an article or newsletter. Describe the drawing medium, palette, and texture in the prompt.
Landscape artwork
Enlarge landscape art while exploring detail in rocks, foliage, or clouds. Compare a restrained pass with a more creative pass before choosing.
Concept art review
Make a larger concept image for reviewing costume materials, buildings, or scenery. Treat added texture as a proposed interpretation and check it against the design brief.
Portrait enlargement trials
Test a larger portrait with low creativity and high resemblance. Review the face against the source before accepting the result.
Product mockup presentations
Enlarge an existing product mockup for a presentation. Describe its materials and lighting, then inspect shapes and markings for unwanted changes.
More on Clarity Upscaler and Gemini CLI
Overview
Clarity Upscaler in other agents
More Gemini CLI guides
Questions about Clarity Upscaler in Gemini CLI
Can Gemini CLI use Clarity Upscaler?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Clarity Upscaler like any built-in tool.
How much does Clarity Upscaler cost in Gemini CLI?
Up to $0.039 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 Clarity Upscaler in Gemini CLI?
No. Spiral runs Clarity Upscaler on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Clarity Upscaler in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Clarity Upscaler runs?
Clarity Upscaler runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.
What is Clarity Upscaler useful for?
Use it to enlarge an existing image while guiding its detail with a prompt. It is useful when you want control over how much the result reinterprets the source.
Will Clarity Upscaler change my image?
It can invent detail, especially at higher creativity. Start with low creativity and high resemblance when preserving the original appearance matters, then compare the result closely.
What should I put in the prompt?
Describe the subject, materials, lighting, and visual style you want retained or refined. For example: 'Ceramic bowl, matte blue glaze, subtle surface texture, soft window light.'
How do I work out the output dimensions?
Multiply the source width and height by the enlargement factor. For example, a 1024 × 1024 image enlarged 2x targets 2048 × 2048 pixels.
How can I repeat a result?
Keep the source image, prompt, seed, settings, and model version unchanged. When comparing settings, hold the seed steady and change one setting at a time.
Start using Clarity Upscaler 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 https://spiral.ai/SKILL.md


