[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [CodeFormer](https://spiral.ai/integrations/dots/codeformer)

# How to Use CodeFormer in dots

CodeFormer restores faces in old photos and AI-generated portraits. Its fidelity control lets you favor cleaner facial details or a closer match to the original.

|  |  |
| --- | --- |
| Model | CodeFormer |
| Available through | fal |
| Category | Image |
| Price | Up to $0.00273 per run at the default inputs. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with CodeFormer in dots

- Each morning, use CodeFormer on new old-photo scans in my designated collection with fidelity at 0.7. Keep the originals and prepare a comparison sheet for review.
- Every Friday, use CodeFormer on newly approved AI-generated portraits at fidelity 0.3 and 0.7. Present both results beside each source for me to choose.
- Each evening, use CodeFormer on new group photographs in my restoration queue with fidelity at 0.7. Prepare face close-ups and flag visible problems around profiles or accessories.
- Once a week, use CodeFormer on new prepared 512 by 512 aligned face crops in my portrait collection. Use the prepared-crop mode and save separate restored copies.
- Each Monday, use CodeFormer to restore new portraits marked for enlargement with fidelity at 0.7 and twice the original dimensions. Include source and output dimensions in the review report.

## How to set up CodeFormer in dots

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

### Use the Spiral skill

1. **Send dots 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### 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 CodeFormer**: 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/codeformer",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg"
    }
  }'
```

Then paste one of the prompts above: dots finds CodeFormer on Spiral, shows the price and runs it.

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

## CodeFormer tools and prices

- [CodeFormer](https://spiral.ai/tools/fal/fal-ai/codeformer) (fal): Up to $0.00273 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| fidelity |  | 0.5 | Weight of the fidelity factor. |
| upscale_factor | 1 to … | 2 | Upscaling factor |
| aligned |  | false | Should faces etc should be aligned. |
| only_center_face |  | false | Should only center face be restored |
| face_upscale |  | true | Should faces be upscaled |
| seed |  | — | Random seed for reproducible generation. |

## What can you do with CodeFormer in dots?

Prepare restored portrait copies whenever new images arrive in a designated collection. Have the agent produce a review batch with originals and settings so you can check appearance before accepting results.

### Restore scanned portraits

Use CodeFormer to make restored copies of old portrait scans. Compare a higher fidelity result with the scan before adding it to a photo collection.

### Repair generated faces

Run CodeFormer on AI-generated portraits with unsatisfactory facial detail. Compare two fidelity settings and inspect the eyes, mouth, and accessories.

### Restore faces within group photos

Use CodeFormer's whole-image processing to restore faces within an old group photograph. Review each person's result and the hair boundaries before keeping the image.

### Prepare portrait enlargements

Restore a portrait with CodeFormer and increase the whole-image dimensions for a larger layout. Inspect facial resemblance and blending at the intended display size.

### Process aligned face crops

Use CodeFormer on prepared, aligned portrait crops for an image collection. The authors' restoration example uses 512 by 512 face images.

### Compare restoration choices

Create CodeFormer results at lower and higher fidelity settings for an editorial review. Keep the source beside both results so an editor can judge resemblance and detail.

## Overview

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

## CodeFormer in other agents

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

## More dots guides

- [Clarity Upscaler](https://spiral.ai/integrations/dots/clarity-upscaler)
- [Color Tint](https://spiral.ai/integrations/dots/color-tint)
- [City Teleport](https://spiral.ai/integrations/dots/city-teleport)
- [Crystal Upscaler](https://spiral.ai/integrations/dots/crystal-upscaler)
- [Chromatic Aberration](https://spiral.ai/integrations/dots/chromatic-aberration)
- [DDColor](https://spiral.ai/integrations/dots/ddcolor)

## Questions about CodeFormer in dots

**Can dots use CodeFormer?**

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

**How much does CodeFormer cost in dots?**

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

**Do I need a fal account to use CodeFormer in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs CodeFormer on its own fal account.

**How long does it take to set up CodeFormer in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while CodeFormer runs?**

CodeFormer runs in the background. dots starts the run, checks on it and gives you the image when it's ready.

**What is CodeFormer useful for?**

Use it to restore facial detail in old photographs or repair faces in AI-generated portraits. Compare the result with the original before keeping it.

**How should I choose the fidelity setting?**

Higher values favor resemblance to the original; lower values favor visual quality. Try 0.3 and 0.7 on the same image, then compare facial features before choosing.

**Does CodeFormer always preserve the person's appearance?**

Identity inconsistencies can remain, especially around unusual accessories. A higher fidelity setting favors resemblance, but review the result yourself.

**What image size does CodeFormer produce?**

The authors demonstrate cropped face restoration at 512 by 512 pixels. For whole images, the final dimensions follow the upscale factor: doubling a 600 by 400 image produces 1200 by 800.

**Where does CodeFormer struggle?**

The authors report failures on side-facing portraits and inconsistencies around accessories. Whole-image blending can also damage hair texture at the restored face's boundary.

