API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Topaz Upscale

topaz/upscale/image

Upscale Image is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Base price
$0.08USD / run
Execution
async
Model type
image
Input fields
18
Production route

Try the model

Playground

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

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Url of the image to be upscaled
0.011
Enhancement strength (0.01-1.0). Applies to Text Refine model only. Range: 0.01 to 1.
Output format of the upscaled image. Allowed values: jpeg, png.
01
Creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled. Range: 0 to 1.
Model to use for image enhancement. Allowed values: Low Resolution V2, Standard V2, CGI, High Fidelity V2, Text Refine, Recovery, Redefine, Recovery V2, Standard MAX, Wonder.
Subject detection mode for the image enhancement. Applies to standard enhance and Recovery V2 models. Allowed values: All, Foreground, Background.
01
Compression artifact removal level (0.0-1.0). Applies to Standard V2, Low Resolution V2, High Fidelity V2, and Text Refine models. Range: 0 to 1.
01
Strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled. Range: 0 to 1.
01
Detail recovery level (0.0-1.0). Applies to Recovery V2 model only. Range: 0 to 1.
16
Creativity level for generative upscaling (1-6). Higher values produce more creative/hallucinated details. Applies to Redefine model only. Range: 1 to 6.
Enable automatic prompt generation for generative upscaling. Applies to Redefine model only.
01
Sharpening level (0.0-1.0). Applies to Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, and Redefine models. Range: 0 to 1.
14
Factor to upscale the image by (e.g. 2.0 doubles width and height) Range: 1 to 4.
15
Texture detail level for generative upscaling (1-5). Applies to Redefine model only. Range: 1 to 5.
01
Denoising level (0.0-1.0). Applies to Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, and Redefine models. Range: 0 to 1.
Whether to apply face enhancement to the image. Applies to standard enhance and Recovery V2 models.
OutputExample

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.08 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
Topaz Labs
Model ID
topaz/upscale/image
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Topaz Upscale

Topaz upscales and enhances images with model presets for low-resolution, CGI, high-fidelity, and face recovery work.

Fields

FieldTypeDefaultNotes
promptstring, required—Optional description for generative models.
imageimage URL, required—Image to upscale. JPEG, PNG, or WebP URL.
strengthnumber 0.01–1—Enhancement strength (0.01-1.0).
output_formatjpeg / pngjpegOutput file format.
face_enhancement_creativitynumber 0–10Creativity level for face enhancement.
enhancement_modelLow Resolution V2 / Standard V2 / CGI / High Fidelity V2 / Text Refine / Recovery / Redefine / Recovery V2 / Standard MAX / WonderStandard V2Model preset.
subject_detectionAll / Foreground / BackgroundAllSubject detection mode for the image enhancement.
crop_to_fillbooleanfalse
fix_compressionnumber 0–1—Compression artifact removal level (0.0-1.0).
face_enhancement_strengthnumber 0–10.8Strength of the face enhancement.
detailnumber 0–1—Detail recovery level (0.0-1.0).
creativityinteger 1–6—Creativity level for generative upscaling (1-6).
autopromptboolean—Enable automatic prompt generation for generative upscaling.
sharpennumber 0–1—Sharpening level (0.0-1.0).
upscale_factornumber 1–421–4×.
textureinteger 1–5—Texture detail level for generative upscaling (1-5).
denoisenumber 0–1—Denoising level (0.0-1.0).
face_enhancementbooleantrueRestore faces.

Billing

Billed by output size: $0.08 up to 24MP, $0.16 up to 48MP, $0.32 up to 96MP, $1.36 above. The quote before submission assumes the top tier; the final charge uses the measured output.

OutputPrice
2× of a 4MP photo (16MP)$0.08
4× of a 2MP photo (32MP)$0.16
4× of a 6MP photo (96MP)$0.32

Failed runs are not charged.

Also on SandBase

Related: clarity-ai/clarity-upscaler, bytedance/seedvr/upscale/image.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
topaz/upscale/image
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "topaz/upscale/image",
  "image": "https://static.sandbase.ai/examples/topaz/upscale/image/input_image_0.jpeg",
  "crop_to_fill": false,
  "output_format": "jpeg",
  "upscale_factor": 2,
  "face_enhancement": true,
  "enhancement_model": "Standard V2",
  "subject_detection": "All",
  "face_enhancement_strength": 0.8,
  "face_enhancement_creativity": 0
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
Topaz UpscaleThis model
Topaz Labs
Image$0.08 / runJun 27, 2025

Questions

FAQ

How do I call Topaz Labs Topaz Upscale through SandBase?

Create a SandBase API key, then send requests with the model ID "topaz/upscale/image" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Topaz Labs account?

No. One SandBase API key and balance gives you access to Topaz Labs Topaz Upscale and the other models in the catalog; you do not need to sign up with Topaz Labs separately.