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

# How to Use Topaz Generative Upscale in Cursor

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, no API key |

## Prompts to try with Topaz Generative Upscale in Cursor

- Use Topaz Generative Upscale with Wonder 3.5 to enlarge the portrait in public/images to twice its width and height at low enhancement strength. Save a separate copy and show the original beside it for review.
- Use Topaz Generative Upscale with Wonder 3 on the landscape asset used by the homepage. Enlarge it 2x and prepare a comparison focused on foliage and repeated textures.
- Use Topaz Generative Upscale with Wonder 3.5 on the compressed article image in this project. Compare low and high enhancement strength at 2x, keeping the original.
- Use Topaz Generative Upscale with Wonder 3.5 to enlarge the chart image in the docs 2x. Compare every readable label and number with the source and report anything uncertain.
- Use Topaz Generative Upscale with Redefine to enlarge the project's AI-generated illustration 2x. Compare creativity levels 1 and 3 and save both results for review.

## How to set up Topaz Generative Upscale in Cursor

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

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

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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 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: Cursor finds Topaz Generative Upscale on Spiral, shows the price and runs it.

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

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

Prepare larger images for a project's pages, reports, or documentation. Have the agent compare source and output dimensions and flag generated details for review.

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

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

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

## Questions about Topaz Generative Upscale in Cursor

**Can Cursor use Topaz Generative Upscale?**

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

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

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

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

No. Spiral runs Topaz Generative Upscale 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 Generative Upscale in Cursor?**

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

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

Topaz Generative Upscale runs in the background. Cursor 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.

