[Integrations](https://spiral.ai/integrations) › [goose](https://spiral.ai/integrations/goose) › [Topaz Restore Image](https://spiral.ai/integrations/goose/topaz-restore-image)

# How to Use Topaz Restore Image in goose

Topaz Restore Image repairs degraded photos, from dusty film scans to compressed portraits. Use Recover 3 to rebuild natural texture or Dust-Scratch V2 to remove scan debris.

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

## Prompts to try with Topaz Restore Image in goose

- Use Topaz Restore Image with Recover 3 on the old portrait in assets/photos. Save a separate result and build a comparison page with close-ups of the face and clothing.
- Use Topaz Restore Image with Dust-Scratch V2 on the scanned photographs in public/archive. Keep the originals and create a review gallery for dust removal and lost detail.
- Use Topaz Restore Image with Recover 3 on the compressed photographic thumbnails in this project. Create a contact sheet comparing each result with its source.
- Use Topaz Restore Image with Dust-Scratch V2 on three representative scans from the archive directory. Add them to a local review page before processing the rest.
- Use Topaz Restore Image with Recover 3 on the soft garden photograph in the project. Show matching crops of the foliage before and after restoration.

## How to set up Topaz Restore Image in goose

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

### Use Spiral's MCP server

1. **Add the extension**: In goose Desktop, open the sidebar, click Extensions, then Add custom extension. Enter:

2. **Sign in**: When goose first connects to Spiral, your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key. If the browser does not open, goose prints the link to open yourself.

### Use the Spiral skill

1. **Send goose 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 Topaz Restore Image**: 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": "topaz/restore/image",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg"
    }
  }'
```

Then paste one of the prompts above: goose finds Topaz Restore Image on Spiral, shows the price and runs it.

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

## Topaz Restore Image tools and prices

- [Topaz Restore Image](https://spiral.ai/tools/fal/topaz/restore/image) (fal): Up to $0.104 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| output_format | jpeg, png | jpeg | Output format of the processed image. |
| model | Recover 3, Dust-Scratch V2 | Recover 3 | Restoration. Recover 3 rebuilds natural detail; Dust-Scratch V2 cleans up film dust and scratches. |

## What can you do with Topaz Restore Image in goose?

Restore degraded photographs used in a website, archive, or content repository with Topaz Restore Image. Have the coding agent prepare comparison pages so you can review faces and fine detail before replacing project assets.

### Restore old portraits

Use Recover 3 to reconstruct facial features, hair, and clothing texture in small or blurry portraits. Compare faces with the original before choosing a result.

### Clean film scans

Use Dust-Scratch V2 to remove dust and scratch marks from scanned photographs. Check fine image detail after cleanup.

### Prepare archival photos for publication

Clean surface damage on digitized prints before further enhancement. Keep the original scan beside the restored copy for editorial review.

### Recover compressed photographs

Use Recover 3 on older JPEG photographs whose faces and natural textures have degraded through compression. Review the reconstruction before replacing a published image.

### Restore foliage texture

Try Recover 3 on degraded garden and landscape photographs where leaves and other organic detail look soft. Compare the recovered texture against the source.

### Recover fabric detail

Use Recover 3 to rebuild fabric texture in degraded clothing photographs. Inspect patterns and seams before approving the restored image.

### Clean a digitization backlog

Apply Dust-Scratch V2 to scanned-photo batches as an early cleanup pass. Review samples for lost detail before continuing with the remaining scans.

## Overview

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

## Topaz Restore Image in other agents

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

## More goose guides

- [Topaz Generative Upscale](https://spiral.ai/integrations/goose/topaz-generative-upscale)
- [Topaz Sharpen Image](https://spiral.ai/integrations/goose/topaz-sharpen-image)
- [Topaz Denoise Image](https://spiral.ai/integrations/goose/topaz-denoise-image)
- [Topaz Transparent Image Upscale](https://spiral.ai/integrations/goose/topaz-transparent-image-upscale)
- [Topaz Bloom 2](https://spiral.ai/integrations/goose/topaz-bloom-2)
- [Topaz Upscale Precision](https://spiral.ai/integrations/goose/topaz-upscale-precision)

## Questions about Topaz Restore Image in goose

**Can goose use Topaz Restore Image?**

Yes. Add Spiral to goose as an MCP server, and goose can find and run Topaz Restore Image like any built-in tool.

**How much does Topaz Restore Image cost in goose?**

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

**Do I need a fal account to use Topaz Restore Image in goose?**

No. Spiral runs Topaz Restore Image on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Topaz Restore Image in goose?**

About two minutes: add the extension, then sign in.

**Does goose wait while Topaz Restore Image runs?**

Topaz Restore Image runs in the background. goose starts the run, checks on it and gives you the image when it's ready.

**What is Topaz Restore Image good at?**

It handles two common restoration jobs: rebuilding natural detail in degraded photos and removing dust or scratches from scans. Portraits, old prints, and compressed photographs are useful starting points.

**When should I choose Recover 3 or Dust-Scratch V2?**

Choose Recover 3 when faces, hair, fabric, or foliage need detail reconstruction. Choose Dust-Scratch V2 when the main problem is dust, specks, or scratches on a scanned photograph.

**Does restoration guarantee that every original detail stays intact?**

Recover 3 generates reconstructed detail, so review faces and textures against the source. Dust-Scratch V2 can remove wanted detail during cleanup; inspect fine features before accepting the result.

**Is Recover 3 suitable for logos and text-heavy images?**

Topaz says Recover 3 is not ideal for images dominated by text or logos. Avoid using it to recover lettering that must remain exact.

**Should I remove dust before rebuilding detail?**

Yes. Topaz recommends blemish cleanup before upscaling or sharpening because later enhancement can amplify the damage.

