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

# How to Use Clarity Upscaler in Windsurf

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.

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

## Prompts to try with Clarity Upscaler in Windsurf

- 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 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 Clarity 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": "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: Windsurf finds Clarity Upscaler on Spiral, shows the price and runs it.

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

## Clarity Upscaler tools and prices

- [Clarity Upscaler](https://spiral.ai/tools/fal/fal-ai/clarity-upscaler) (fal): Up to $0.039 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  | masterpiece, best quality, highres | The prompt to use for generating the image. Be as descriptive as possible for best results. |
| upscale_factor | 1 to 4 | 2 | The upscale factor |
| negative_prompt |  | (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 | 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. |

## What can you do with Clarity Upscaler in Windsurf?

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.

## Overview

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

## Clarity Upscaler in other agents

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

## More Windsurf guides

- [City Teleport](https://spiral.ai/integrations/windsurf/city-teleport)
- [CodeFormer](https://spiral.ai/integrations/windsurf/codeformer)
- [Chromatic Aberration](https://spiral.ai/integrations/windsurf/chromatic-aberration)
- [Color Tint](https://spiral.ai/integrations/windsurf/color-tint)
- [Cartoonify](https://spiral.ai/integrations/windsurf/cartoonify)
- [Crystal Upscaler](https://spiral.ai/integrations/windsurf/crystal-upscaler)

## Questions about Clarity Upscaler in Windsurf

**Can Windsurf use Clarity Upscaler?**

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

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

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

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

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

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

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

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

