Image Upscaling
Prompt
“”
Professional-grade image upscaler from Topaz Labs offering five specialized models (Standard, Low Resolution, CGI, High Fidelity, Text Refine) with optional face enhancement
Hover to compare original and upscaled detail
Drag to compare original and upscaled detail
Details
Model ID
topaz-image-upscale
Also known as:
topaz-image, gigapixel
Tags
image-upscaling
super-resolution
image-enhancement
high-quality
Providers & Pricing (2)
fal.ai
fal/topaz-image-upscale
Provider Model ID:
fal-ai/topaz/upscale/image
Output
Image
—
per image
Pricing Notes (2)
- • Tiered pricing based on output image megapixels.
- • Up to 24 MP: $0.08, up to 48 MP: $0.16, up to 96 MP: $0.32, up to 512 MP: $1.36
View official pricing
• As of
Replicate
replicate/topaz-image-upscale
Provider Model ID:
topazlabs/image-upscale
Output
Image
—
per image
Pricing Notes (2)
- • Tiered pricing based on output image megapixels.
- • Up to 24 MP: $0.05, up to 48 MP: $0.10, up to 60 MP: $0.15, up to 96 MP: $0.20, up to 132 MP: $0.24, up to 168 MP: $0.29, up to 336 MP: $0.53, up to 512 MP: $0.82
View official pricing
• As of
topaz-image API OpenAI-compatible
Base URL
https://api.lumenfall.ai/openai/v1
Model
topaz-image-upscale
Code Examples
Upscale
/v1/images/editscurl -X POST \ https://api.lumenfall.ai/openai/v1/images/edits \ -H "Authorization: Bearer $LUMENFALL_API_KEY" \ -F "model=topaz-image-upscale" \ -F "[email protected]" \ -F "prompt=Add a starry night sky to this image" \ -F "size=1024x1024"# Response:# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }import OpenAI from 'openai';import fs from 'fs';const client = new OpenAI({ apiKey: 'YOUR_API_KEY', baseURL: 'https://api.lumenfall.ai/openai/v1'});const response = await client.images.edit({ model: 'topaz-image-upscale', image: fs.createReadStream('source.png'), prompt: 'Add a starry night sky to this image', size: '1024x1024'});// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }console.log(response.data[0].url);from openai import OpenAIclient = OpenAI( api_key="YOUR_API_KEY", base_url="https://api.lumenfall.ai/openai/v1")response = client.images.edit( model="topaz-image-upscale", image=open("source.png", "rb"), prompt="Add a starry night sky to this image", size="1024x1024")# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }print(response.data[0].url)Parameter Reference
Required
Supported
Not available
Media Inputs
| Parameter | Type | Description | Modes |
|---|---|---|---|
image
|
file |
Required.
Input image to upscale
Single image per request.
|
Upscale
|
scale_factor
|
number |
Required.
Factor by which to upscale the image
2x
4x
6x
None
|
Upscale
|
Output & Format
| Parameter | Type | Description | Modes |
|---|---|---|---|
response_format
|
string |
How to return the image
url
b64_json
Default:
"url" |
Upscale
|
output_format
|
string |
Output image format
png
jpeg
gif
webp
avif
Gateway converts to requested format if provider doesn't support it natively.
|
Upscale
|
output_compression
|
integer | Compression level for lossy formats (JPEG, WebP, AVIF) |
Upscale
|
n
|
integer |
Number of images to generate
Default:
1Gateway generates multiple images in parallel even if provider only supports 1.
|
Upscale
|
Additional Parameters
Provider-specific passthrough fields, available only when the request is routed to the listed provider.
| Parameter | Type | Description | Modes |
|---|---|---|---|
|
Universal
|
|||
face_enhancement
|
boolean | Enable face enhancement |
Upscale
|
face_enhancement_strength
|
number | Strength of face enhancement (0-1) |
Upscale
|
subject_detection
|
string |
Subject detection mode
All
Background
Foreground
None
|
Upscale
|
|
fal
|
|||
crop_to_fill
|
boolean | Crop to fill output dimensions |
Upscale
|
model
|
string |
Enhancement model to use
CGI
High Fidelity V2
Low Resolution V2
Standard V2
Text Refine
|
Upscale
|
|
replicate
|
|||
enhance_model
|
string |
Enhancement model to use
CGI
High Fidelity V2
Low Resolution V2
Standard V2
Text Refine
|
Upscale
|
face_enhancement_creativity
|
number | Creativity for face enhancement (0-1) |
Upscale
|
Parameter Normalization
How we handle parameters across different providers
Not every provider speaks the same language. When you send a parameter, we handle it in one of four ways depending on what the model supports:
| Behavior | What happens | Example |
|---|---|---|
passthrough |
Sent as-is to the provider | style, quality |
renamed |
Same value, mapped to the field name the provider expects | prompt |
converted |
Transformed to the provider's native format | size |
emulated |
Works even if the provider has no concept of it | n, response_format |
Parameters we don't recognize pass straight through to the upstream API, so provider-specific options still work.
Topaz Image Upscale Benchmarks
Topaz Image Upscale is ranked #3 in Image Upscaling with an Elo of 1125 on the Lumenfall Arena, where real users pick the better image in blind comparisons. These rankings are based on 1 blind-vote competition.
Lumenfall Arena
#3
Image Upscaling
1125
Elo
Image Upscaling Landscape
Elo vs Cost
1 model without pricing omitted
Elo vs Speed
Speed data is still warming up
We only have enough recent requests for Crystal Upscaler (28.4s average).
3 models waiting for enough speed data
Competition Results
Uncategorized
Top Matchups
See how Topaz Image Upscale performs head-to-head against other AI models, ranked by community votes in blind comparisons.
Gallery
View all 1 imagesTopaz Image Upscale FAQ
How do I use Topaz Image Upscale via API?
You can use Topaz Image Upscale through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "topaz-image-upscale". Code examples are available in Python, JavaScript, and cURL.
Which providers offer Topaz Image Upscale?
Topaz Image Upscale is available through Replicate and fal.ai on Lumenfall. Lumenfall automatically routes requests to the best available provider.
Try Topaz Image Upscale in Playground
Generate images with custom prompts — no API key needed.