Topaz Upscale

Name: Topaz Labs Topaz Upscale
Price: 0.08 USD
Availability: InStock
Author: Topaz Labs

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.

Try the model

Playground

Open playground

Input

Prompt(string)

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

Image Url(string)

Upload

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

Url of the image to be upscaled

This field is required.

Additional Settings More

Customize your input with more control.

Strength(number)

0.011

Enhancement strength (0.01-1.0). Applies to Text Refine model only. Range: 0.01 to 1.

Output Format(string)

Output format of the upscaled image. Allowed values: jpeg, png.

Face Enhancement Creativity(number)

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.

Enhancement Model(string)

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(string)

Subject detection mode for the image enhancement. Applies to standard enhance and Recovery V2 models. Allowed values: All, Foreground, Background.

Crop To Fill(boolean)

Fix Compression(number)

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.

Face Enhancement Strength(number)

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.

Detail(number)

Detail recovery level (0.0-1.0). Applies to Recovery V2 model only. Range: 0 to 1.

Creativity(integer)

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

Autoprompt(boolean)

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

Sharpen(number)

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.

Upscale Factor(number)

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

Texture(integer)

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

Denoise(number)

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.

Face Enhancement(boolean)

Whether to apply face enhancement to the image. Applies to standard enhance and Recovery V2 models.

Result

Example

What would you like to do next?
Open original

Examples

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

Input

{
  "crop_to_fill": false,
  "enhancement_model": "High Fidelity V2",
  "face_enhancement": false,
  "image": "https://static.sandbase.ai/examples/5f434c76-3c13-4430-ac6e-a044487d42b4/input/235e21e0-6bcc-4297-853b-0d3db8894545.png",
  "output_format": "png",
  "prompt": "Preserve the original panoramic composition, geometry, colors, and details while increasing resolution. Do not crop, reframe, or add new objects.",
  "upscale_factor": 2.844444444444445
}

Open result ↗

Input

{
  "crop_to_fill": false,
  "enhancement_model": "High Fidelity V2",
  "face_enhancement": false,
  "image": "https://static.sandbase.ai/examples/837dea98-dbac-4482-b0ba-221473d90d81/input/743b1eb0-8027-4702-bee2-089ad9855502.png",
  "output_format": "png",
  "prompt": "Preserve the original panoramic composition, geometry, colors, and details while increasing resolution. Do not crop, reframe, or add new objects.",
  "upscale_factor": 2.844444444444445
}

Open result ↗

Topaz Upscale

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

Fields

Field	Type	Default	Notes
`prompt`	string, required	—	Optional description for generative models.
`image`	image URL, required	—	Image to upscale. JPEG, PNG, or WebP URL.
`strength`	number 0.01–1	—	Enhancement strength (0.01-1.0).
`output_format`	`jpeg` / `png`	`jpeg`	Output file format.
`face_enhancement_creativity`	number 0–1	0	Creativity level for face enhancement.
`enhancement_model`	`Low Resolution V2` / `Standard V2` / `CGI` / `High Fidelity V2` / `Text Refine` / `Recovery` / `Redefine` / `Recovery V2` / `Standard MAX` / `Wonder`	`Standard V2`	Model preset.
`subject_detection`	`All` / `Foreground` / `Background`	`All`	Subject detection mode for the image enhancement.
`crop_to_fill`	boolean	false
`fix_compression`	number 0–1	—	Compression artifact removal level (0.0-1.0).
`face_enhancement_strength`	number 0–1	0.8	Strength of the face enhancement.
`detail`	number 0–1	—	Detail recovery level (0.0-1.0).
`creativity`	integer 1–6	—	Creativity level for generative upscaling (1-6).
`autoprompt`	boolean	—	Enable automatic prompt generation for generative upscaling.
`sharpen`	number 0–1	—	Sharpening level (0.0-1.0).
`upscale_factor`	number 1–4	2	1–4×.
`texture`	integer 1–5	—	Texture detail level for generative upscaling (1-5).
`denoise`	number 0–1	—	Denoising level (0.0-1.0).
`face_enhancement`	boolean	true	Restore 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.

Output	Price
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

Submit this model through the SandBase Unified Run API.

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"

2. Authentication

Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.

API key environment variable

export SANDBASE_API_KEY="YOUR_API_KEY"

Keep the key on your server. Do not expose it in browser code or commit it to a repository.

3. Queue

Submit a request

POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.

Fetch request status and result

Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.

Poll run status

curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

4. Files

Hosted files

Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.

Uploading images

Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.

5. Schema

Input

`image`stringrequired

Url of the image to be upscaled

`detail`number

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

Minimum: 0

Maximum: 1

`prompt`stringrequired

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

`denoise`number

Denoising level (0.0-1.0). Applies to Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, and Redefine models.

Minimum: 0

Maximum: 1

`sharpen`number

Sharpening level (0.0-1.0). Applies to Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, and Redefine models.

Minimum: 0

Maximum: 1

`texture`integer

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

Minimum: 1

Maximum: 5

`strength`number

Enhancement strength (0.01-1.0). Applies to Text Refine model only.

Minimum: 0.01

Maximum: 1

`autoprompt`boolean

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

`creativity`integer

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

Minimum: 1

Maximum: 6

`crop_to_fill`boolean

Default: false

`output_format`string

Output format of the upscaled image.

Default: "jpeg"

Possible values: "jpeg", "png"

`upscale_factor`number

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

Default: 2

Minimum: 1

Maximum: 4

`fix_compression`number

Compression artifact removal level (0.0-1.0). Applies to Standard V2, Low Resolution V2, High Fidelity V2, and Text Refine models.

Minimum: 0

Maximum: 1

`face_enhancement`boolean

Whether to apply face enhancement to the image. Applies to standard enhance and Recovery V2 models.

Default: true

`enhancement_model`string

Model to use for image enhancement.

Default: "Standard V2"

Possible values: "Low Resolution V2", "Standard V2", "CGI", "High Fidelity V2", "Text Refine", "Recovery", "Redefine", "Recovery V2", "Standard MAX", "Wonder"

`subject_detection`string

Subject detection mode for the image enhancement. Applies to standard enhance and Recovery V2 models.

Default: "All"

Possible values: "All", "Foreground", "Background"

`face_enhancement_strength`number

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

Default: 0.8

Minimum: 0

Maximum: 1

`face_enhancement_creativity`number

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

Default: 0

Minimum: 0

Maximum: 1

Request body

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

Output

A completed run exposes its result in output. The following is the model’s saved example, not a new generation.

Example output JSON

[
  {
    "source": "Completed user prediction (human visual safety screened)",
    "source_url": "https://www.sandbase.ai",
    "url": "https://static.sandbase.ai/examples/5f434c76-3c13-4430-ac6e-a044487d42b4/output/dacc1c12-12fe-48ef-8089-c5e0add47a26.png"
  }
]

Topaz Upscale

Playground

Examples

Topaz Upscale

Fields

Billing

Also on SandBase

Send your first request

2. Authentication

3. Queue

Submit a request

Fetch request status and result

4. Files

Hosted files

Uploading images

5. Schema

Input

imagestringrequired

detailnumber

promptstringrequired

denoisenumber

sharpennumber

textureinteger

strengthnumber

autopromptboolean

creativityinteger

crop_to_fillboolean

output_formatstring

upscale_factornumber

fix_compressionnumber

face_enhancementboolean

enhancement_modelstring

subject_detectionstring

face_enhancement_strengthnumber

face_enhancement_creativitynumber

Output

`image`stringrequired

`detail`number

`prompt`stringrequired

`denoise`number

`sharpen`number

`texture`integer

`strength`number

`autoprompt`boolean

`creativity`integer

`crop_to_fill`boolean

`output_format`string

`upscale_factor`number

`fix_compression`number

`face_enhancement`boolean

`enhancement_model`string

`subject_detection`string

`face_enhancement_strength`number

`face_enhancement_creativity`number