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

# How to Use Crystal Upscaler in Windsurf

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 Windsurf

- Use Crystal Upscaler to enlarge the team headshots in public/images/team by 2x with creativity at zero. Save separate copies and build a local comparison page for reviewing faces.
- Use Crystal Upscaler on the product packshots in public/images/products at 2x with creativity at zero. Save the results separately and prepare side-by-side crops of every label.
- Use Crystal Upscaler to create 4x copies of the garment photos in assets/lookbook with creativity at zero. Make a review page with close-ups of fabric texture.
- Use Crystal Upscaler on the interior photographs in public/images/properties at 2x with creativity at zero. Create before-and-after comparisons focused on window frames and material textures.
- Use Crystal Upscaler to enlarge assets/print/portrait.jpg by 4x with creativity at zero. Save a separate print candidate and a review crop of the face.

## How to set up Crystal Upscaler in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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: Windsurf finds Crystal Upscaler on Spiral, shows the price and runs it.

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

## 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 Windsurf?

Prepare larger portraits, product photos, and property images for a website or app with Crystal Upscaler. A coding agent can work from project assets, save enlarged copies, and organize comparisons before you replace the originals.

### 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 Windsurf guides](https://spiral.ai/integrations/windsurf)

## 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](https://spiral.ai/integrations/gemini/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)
- [Zapier](https://spiral.ai/integrations/zapier/crystal-upscaler)

## More Windsurf guides

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

## Questions about Crystal Upscaler in Windsurf

**Can Windsurf use Crystal Upscaler?**

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

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

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 Windsurf plan is separate.

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

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 Windsurf?**

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

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

Crystal Upscaler runs in the background. Windsurf 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.

