Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · ImageReleased 2026-08-11

How to Use Topaz Generative Upscale in Windsurf

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.

Prompts to try with Topaz Generative Upscale in Windsurf

Copy an example into Windsurf, or ask in your own words.

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.

Topaz Generative UpscaleWindsurf
Try asking
  • 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 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:

    {
      "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.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    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.

    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.

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

Topaz Generative Upscale providers and prices

Spiral runs Topaz Generative Upscale through fal. Open a card for today's price, with every fee included.

falImage
Topaz Upscale · Generative Image Upscaling
topaz/upscale/image/generative

Settings you can ask for

Topaz Generative Upscale works from your image URL and prompt. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
ModelWonder 3.5, Wonder 3, Wonder 2, Wonder, Recover 3, Standard MAX, Redefine, Recovery V2 and 1 moreWonder 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 factor1 to 42

Factor to upscale the image by (e.g. 2.0 doubles width and height)

Crop to fillon or offoff
Output formatjpeg or pngjpeg

Output format of the upscaled image.

Subject detectionAll, Foreground, or BackgroundAll

Subject detection mode for the image enhancement. Applies to Wonder 3, Recovery and Recovery V2 models.

Face enhancementon or offon

Whether to apply face enhancement to the image.

Face enhancement creativity0 to 10

Creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled.

Face enhancement strength0 to 10.8

Strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled.

Enhancement strengthlow, medium, or high

Enhancement strength for generative upscaling. Applies to Wonder 3 and Wonder 3.5 models. When omitted, Topaz auto-configures it.

Creativity1 to 6

Creativity level for generative upscaling (1-6). Higher values produce more creative/hallucinated details. Applies to Redefine model only.

Texture1 to 5

Texture detail level for generative upscaling (1-5). Applies to Redefine model only.

Autoprompton or off

Enable automatic prompt generation for generative upscaling. Applies to Redefine model only.

Sharpen0 to 1

Sharpening level (0.0-1.0). Applies to Redefine model only.

Denoise0 to 1

Denoising level (0.0-1.0). Applies to Redefine model only.

Detail0 to 1

Detail recovery level (0.0-1.0). Applies to Recovery V2 model only.

Every API field of Topaz Upscale · Generative Image Upscaling is on its tool page: open its card above.

What can you do with Topaz Generative Upscale in Windsurf?

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.

Questions about Topaz Generative Upscale in Windsurf

Can Windsurf use Topaz Generative Upscale?

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

How much does Topaz Generative Upscale cost in Windsurf?

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

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

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

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

Does Windsurf wait while Topaz Generative Upscale runs?

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

Get started

Start using Topaz Generative Upscale in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options