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

falImageAvailable nowReleased 2026-08-11

Topaz Upscale · Generative Image Upscaling

topaz/upscale/image/generative

Edit and enhance images with Topaz Upscale · Generative Image Upscaling from fal through one Spiral API key. Upscales an image up to 4x with Topaz generative models such as Wonder and Redefine, which add fresh detail and can enhance faces. It runs in the background and returns images. Pay as you go, with no subscription.

Run time p50 · last 24 hours
28.0s
Success rate · last 24 hours
100.0%

Pricing

$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.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
4 hours
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
image_url requiredURL or file—

Url of the image to be upscaled

modelone of
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_factornumber
1 to 4
2

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

crop_to_filltrue or falsefalse
output_formatone of
jpeg, png
jpeg

Output format of the upscaled image.

subject_detectionone of
All, Foreground, Background
All

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

face_enhancementtrue or falsetrue

Whether to apply face enhancement to the image.

face_enhancement_creativitynumber
0 to 1
0

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

face_enhancement_strengthnumber
0 to 1
0.8

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

enhancement_strengthone of
low, medium, high
—

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

creativitynumber (whole)
1 to 6
—

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

texturenumber (whole)
1 to 5
—

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

prompttext—

Text prompt to guide generative upscaling (max 1024 chars). Applies to Redefine model only.

autoprompttrue or false—

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

sharpennumber
0 to 1
—

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

denoisenumber
0 to 1
—

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

detailnumber
0 to 1
—

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

Same request in code

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"
    }
  }'

Frequently asked questions

How much does Topaz Upscale · Generative Image Upscaling cost?

$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 as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Topaz Upscale · Generative Image Upscaling through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "topaz/upscale/image/generative"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Topaz Upscale · Generative Image Upscaling?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Topaz Upscale · Generative Image Upscaling?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.