[Integrations](https://spiral.ai/integrations) › [Gemini](https://spiral.ai/integrations/gemini) › [Crystal Upscaler](https://spiral.ai/integrations/gemini/crystal-upscaler)

# How to Use Crystal Upscaler in Gemini

Crystal Upscaler enlarges portraits, product photos, fashion shots, and architectural images with an emphasis on preserving detail. Start with low creativity for faithful results; raise it when you want more reconstruction.

|  |  |
| --- | --- |
| Model | Crystal Upscaler |
| Available through | fal |
| Category | Image |
| Price | Up to $0.0208 per run at the default inputs. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Crystal Upscaler in Gemini

- Use Crystal Upscaler to enlarge the attached headshot to twice its size with creativity at zero. Show me the result so I can check the eyes and skin texture.
- Use Crystal Upscaler to enlarge this product photo to four times its size with creativity at zero. Include a close-up comparison of the label.
- Use Crystal Upscaler on this fashion photo at twice its size with creativity at zero. Show a comparison crop of the fabric.
- Use Crystal Upscaler to enlarge this room photograph to twice its size with creativity at zero. Show the original and result together for checking architectural edges.
- Use Crystal Upscaler to make two enlargements of this blurry portrait at twice its size: one with creativity at zero and one with creativity at three. Let me compare the facial details.

## How to set up Crystal Upscaler in Gemini

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

### Use the Gemini connector

1. **Open Connected Apps**: On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

2. **Add Spiral as a custom app**: Under Custom apps, click Add a custom app and paste this MCP server URL:

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

### Use the Spiral skill

1. **Send Gemini 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Crystal Upscaler**: One request; the result comes back by polling or a webhook.

```bash
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": "clarityai/crystal-upscaler",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/zebra/eW3waMFDT-2_7Pq8j3r9d_upscaled.png"
    }
  }'
```

Then paste one of the prompts above: Gemini finds Crystal Upscaler on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini

## Crystal Upscaler tools and prices

- [Crystal Upscaler · Upscale Image](https://spiral.ai/tools/fal/clarityai/crystal-upscaler) (fal): Up to $0.0208 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| scale_factor | 1 to 200 | 2 | Scale factor |
| creativity | 0 to 10 | 0 | Creativity level for upscaling |
| output_format | png, jpg | jpg | Output image format |

## What can you do with Crystal Upscaler in Gemini?

Turn an existing headshot, product photo, or architectural image into a larger image with Crystal Upscaler. A chat app can help you choose an enlargement and compare conservative results with a more reconstructive pass.

### Larger professional headshots

Enlarge an existing headshot for a profile or speaker page. Start with low creativity and inspect facial features before approving it.

### Product listing images

Enlarge packshots for product galleries and marketplace listings. Compare label text and product details with the source.

### Fashion photography

Prepare larger versions of garment photos, with particular attention to fabric texture and model details.

### Real estate interiors

Enlarge existing room photographs for property galleries. Review material textures and architectural edges in the result.

### Architectural exteriors and renderings

Create larger presentation images from existing exterior photographs or architectural renderings. Check geometry against the original.

### Print preparation

Enlarge a small preview for a poster or other print layout. Choose the required output size and inspect a detail crop before printing.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini guides](https://spiral.ai/integrations/gemini)

## Crystal Upscaler in other agents

- [Amp](https://spiral.ai/integrations/amp/crystal-upscaler)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/crystal-upscaler)
- [Claude](https://spiral.ai/integrations/claude-desktop/crystal-upscaler)
- [Claude Code](https://spiral.ai/integrations/claude-code/crystal-upscaler)
- [Cline](https://spiral.ai/integrations/cline/crystal-upscaler)
- [Codex](https://spiral.ai/integrations/codex/crystal-upscaler)
- [Cursor](https://spiral.ai/integrations/cursor/crystal-upscaler)
- [Devin](https://spiral.ai/integrations/devin/crystal-upscaler)
- [dots](https://spiral.ai/integrations/dots/crystal-upscaler)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/crystal-upscaler)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/crystal-upscaler)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/crystal-upscaler)
- [goose](https://spiral.ai/integrations/goose/crystal-upscaler)
- [Grok](https://spiral.ai/integrations/grok/crystal-upscaler)
- [Grok Build](https://spiral.ai/integrations/grok-build/crystal-upscaler)
- [Hermes](https://spiral.ai/integrations/hermes/crystal-upscaler)
- [Instinct](https://spiral.ai/integrations/instinct/crystal-upscaler)
- [Manus](https://spiral.ai/integrations/manus/crystal-upscaler)
- [Muse](https://spiral.ai/integrations/muse/crystal-upscaler)
- [Muse Code](https://spiral.ai/integrations/muse-code/crystal-upscaler)
- [n8n](https://spiral.ai/integrations/n8n/crystal-upscaler)
- [Notion](https://spiral.ai/integrations/notion/crystal-upscaler)
- [OpenClaw](https://spiral.ai/integrations/openclaw/crystal-upscaler)
- [opencode](https://spiral.ai/integrations/opencode/crystal-upscaler)
- [Perplexity](https://spiral.ai/integrations/perplexity/crystal-upscaler)
- [Raycast](https://spiral.ai/integrations/raycast/crystal-upscaler)
- [VS Code](https://spiral.ai/integrations/vscode/crystal-upscaler)
- [Windsurf](https://spiral.ai/integrations/windsurf/crystal-upscaler)
- [Zapier](https://spiral.ai/integrations/zapier/crystal-upscaler)

## More Gemini guides

- [Color Tint](https://spiral.ai/integrations/gemini/color-tint)
- [DDColor](https://spiral.ai/integrations/gemini/ddcolor)
- [CodeFormer](https://spiral.ai/integrations/gemini/codeformer)
- [Dissolve](https://spiral.ai/integrations/gemini/dissolve)
- [Clarity Upscaler](https://spiral.ai/integrations/gemini/clarity-upscaler)
- [Dodge Burn](https://spiral.ai/integrations/gemini/dodge-burn)

## Questions about Crystal Upscaler in Gemini

**Can Gemini use Crystal Upscaler?**

Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Crystal Upscaler like any built-in tool.

**How much does Crystal Upscaler cost in Gemini?**

Up to $0.0208 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 plan is separate.

**Do I need a fal account to use Crystal Upscaler in Gemini?**

No. Spiral runs Crystal 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 Crystal Upscaler in Gemini?**

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

**Does Gemini wait while Crystal Upscaler runs?**

Crystal Upscaler runs in the background. Gemini starts the run, checks on it and gives you the image when it's ready.

**What is Crystal Upscaler best for?**

Crystal Upscaler suits portraits, product photos, fashion photography, and architectural images. Choose it when you want to enlarge an existing image while keeping its details recognizable.

**How should I set creativity?**

Start low when preserving a face, garment, or product matters. Higher creativity permits more reconstruction, so compare the result with the original before keeping it.

**Can Crystal Upscaler improve blurry photos?**

The maker describes it as reducing blur and noise while enhancing real detail. Try a low-creativity pass first, then inspect the areas that were unclear in the source.

**How large can Crystal Upscaler make an image?**

The maker reports an output ceiling of 1.5 gigapixels and says larger requests are rejected. Choose an enlargement that stays below that ceiling rather than assuming the maximum scale will fit every source image.

**Is Crystal Upscaler useful for print?**

Yes. Clarity AI presents enlarging small previews for print as a use, including output intended for 300 DPI printing. Inspect a detail crop before committing to the full print.

