[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Topaz Generative Upscale](https://spiral.ai/integrations/n8n/topaz-generative-upscale)

# How to Use Topaz Generative Upscale in n8n

Topaz Generative Upscale enlarges small or blurry images by reconstructing detail. Choose Wonder 3.5 for photo repair with fewer repetitive patterns than Wonder 3, or Redefine for creative work on AI-generated images.

|  |  |
| --- | --- |
| Model | Topaz Generative Upscale |
| Available through | fal |
| Category | Image |
| Price | $0.104 per started 8 megapixels of output with Wonder 3 or 3.5 (per started 4 megapixels with other models). Output is the input size × the upscale factor squared. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Topaz Generative Upscale in n8n

- Each Monday, use Topaz Generative Upscale with Wonder 3.5 on newly submitted portraits. Double their dimensions with low enhancement strength and collect original-and-result comparisons for approval.
- Every Friday, use Topaz Generative Upscale with Wonder 3 on newly submitted landscape photos. Enlarge each twice and prepare comparisons focused on foliage and repeated textures.
- Each morning, use Topaz Generative Upscale with Wonder 3.5 on newly submitted compressed editorial photos. Make enlargements at twice the dimensions with low enhancement strength and place them in the review queue.
- Each week, use Topaz Generative Upscale with Wonder 3.5 to double the dimensions of newly submitted chart images. Compare readable labels and numbers with the originals and flag uncertain results for review.
- Every Tuesday, use Topaz Generative Upscale with Redefine on newly submitted AI-generated illustrations. Enlarge each twice using low creativity and collect the results beside their originals for approval.

## How to set up Topaz Generative Upscale in n8n

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

### Use the Spiral skill

1. **Send n8n 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 a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

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

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run Topaz Generative Upscale in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Topaz Generative Upscale, prices it and runs it each time the step fires.

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

Then paste one of the prompts above: n8n finds Topaz Generative Upscale on Spiral, shows the price and runs it.

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

## Topaz Generative Upscale tools and prices

- [Topaz Upscale · Generative Image Upscaling](https://spiral.ai/tools/fal/topaz/upscale/image/generative) (fal): $0.104 per started 8 megapixels of output with Wonder 3 or 3.5 (per started 4 megapixels with other models). Output is the input size × the upscale factor squared.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| model | Wonder 3.5, Wonder 3, Wonder 2, Wonder, Recover 3, Standard MAX, Redefine, Recovery V2, Recovery | Wonder 3 | Generative upscaling model. Wonder 3.5 is the latest Wonder with finer detail and fewer repetitive patterns; Wonder 3 is Topaz's most advanced generative realism model (Wonder 2/Wonder are earlier generations); Recover 3 rebuilds natural detail; Standard MAX is high-quality precision-leaning upscaling; Redefine adds prompt-guided creative detail; Recovery and Recovery V2 rebuild extreme low-resolution images. |
| upscale_factor | 1 to 4 | 2 | Factor to upscale the image by (e.g. 2.0 doubles width and height) |
| crop_to_fill |  | false |  |
| output_format | jpeg, png | jpeg | Output format of the upscaled image. |
| subject_detection | All, Foreground, Background | All | Subject detection mode for the image enhancement. Applies to Wonder 3, Recovery and Recovery V2 models. |
| face_enhancement |  | true | Whether to apply face enhancement to the image. |

## What can you do with Topaz Generative Upscale in n8n?

Prepare review copies of newly supplied images on a schedule. Preserve the originals and collect comparisons so someone can approve the reconstructed details.

### Enlarge a portrait for a profile page

Try Wonder 3.5 on a small portrait, starting with low enhancement strength. Compare the expression, skin, and hair with the original before publishing.

### Prepare a landscape for a larger layout

Enlarge a landscape with Wonder 3 or Wonder 3.5, then inspect foliage and other repeated textures for invented patterns.

### Enlarge wildlife photographs

Use Wonder 3 on a small wildlife photo to work on feathers, fur, and surrounding textures. Review those details against the source.

### Repair compressed editorial images

Try Wonder 3.5 on a compressed image needed for an article or newsletter. Compare low and high enhancement strength before choosing the result.

### Enlarge tables and charts for review

Try Wonder 3.5 on an existing chart or table image. Check every label, number, and line against the original before including it in a report.

### Develop detail in AI-generated artwork

Try Redefine on an AI-generated illustration when creative reconstruction is welcome. Compare restrained and stronger creativity settings, checking for unwanted changes.

## Overview

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

## Topaz Generative Upscale in other agents

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

## More n8n guides

- [Topaz Denoise Image](https://spiral.ai/integrations/n8n/topaz-denoise-image)
- [Topaz Restore Image](https://spiral.ai/integrations/n8n/topaz-restore-image)
- [Topaz Bloom 2](https://spiral.ai/integrations/n8n/topaz-bloom-2)
- [Topaz Sharpen Image](https://spiral.ai/integrations/n8n/topaz-sharpen-image)
- [Topaz Adjust Image](https://spiral.ai/integrations/n8n/topaz-adjust-image)
- [Topaz Transparent Image Upscale](https://spiral.ai/integrations/n8n/topaz-transparent-image-upscale)

## Questions about Topaz Generative Upscale in n8n

**Can n8n use Topaz Generative Upscale?**

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run Topaz Generative Upscale like any built-in tool.

**How much does Topaz Generative Upscale cost in n8n?**

$0.104 per started 8 megapixels of output with Wonder 3 or 3.5 (per started 4 megapixels with other models). Output is the input size × the upscale factor squared. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your n8n plan is separate.

**Do I need a fal account to use Topaz Generative Upscale in n8n?**

You need no fal account. n8n uses one Spiral API key for every tool, and Spiral runs Topaz Generative Upscale on its own fal account.

**How long does it take to set up Topaz Generative Upscale in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while Topaz Generative Upscale runs?**

Topaz Generative Upscale runs in the background. n8n starts the run, checks on it and gives you the image when it's ready.

**What is Topaz Generative Upscale useful for?**

Use it to enlarge small or blurry images and reconstruct detail. Wonder 3 suits portraits, landscapes, wildlife, and textures such as fabric and feathers.

**Does Topaz Generative Upscale recover the exact original detail?**

It can invent detail that the source no longer contains. Keep the original and check generated details before using the result where accuracy matters.

**How does Wonder 3.5 differ from Wonder 3?**

Wonder 3.5 produces finer detail with fewer repetitive patterns and better handling of visual noise. Its improvements are especially useful on degraded or compressed images.

**Which enhancement strength should I start with?**

Start with low when preserving the source matters most. Try high when you accept more creative reconstruction, then compare the result with the original.

**What does a 2x upscale mean for image dimensions?**

It doubles the width and height. An 800 × 600 image becomes 1600 × 1200, giving you four times as many pixels.

