topaz/upscale/image/precision

Name: Topaz Upscale Image Precision
Author: Topaz Labs

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

Input

Image URL or upload(string)

Upload

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

Url of the image to be upscaled

This field is required.

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.

Denoise(number)

Denoising level (0.0-1.0). Default varies by model. Range: 0 to 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. 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.

Fix Compression(number)

Compression artifact removal level (0.0-1.0). Not supported by the CGI model. Range: 0 to 1.

Crop To Fill(boolean)

Upscale Factor(number)

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

Face Enhancement(boolean)

Whether to apply face enhancement to the image.

Subject Detection(string)

Subject detection mode for the image enhancement. Allowed values: All, Foreground, Background.

Sharpen(number)

Sharpening level (0.0-1.0). Default varies by model. Range: 0 to 1.

Model(string)

Precision upscaling model. Standard V2 fits most photos; High Fidelity V3/V2 preserve detail in professional shots; Low Resolution V2 recovers compressed sources; CGI targets art and rendered graphics; Text Refine keeps text and shapes crisp. Allowed values: Standard V2, High Fidelity V3, High Fidelity V2, Low Resolution V2, CGI, Text Refine.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDtopaz/upscale/image/precision

Input Schema

13 parameters · 1 required · 12 optional

Parameter	Type	Required	Description
`image`	string	Required	Url of the image to be upscaled · Min length: 1
`model`	string	Optional	Precision upscaling model. Standard V2 fits most photos; High Fidelity V3/V2 preserve detail in professional shots; Low Resolution V2 recovers compressed sources; CGI targets art and rendered graphics; Text Refine keeps text and shapes crisp. · Options: Standard V2, High Fidelity V3, High Fidelity V2, Low Resolution V2, CGI, Text Refine · Default: "Standard V2" Standard V2High Fidelity V3High Fidelity V2Low Resolution V2CGIText Refine
`denoise`	number	Optional	Denoising level (0.0-1.0). Default varies by model. · Min: 0 · Max: 1
`sharpen`	number	Optional	Sharpening level (0.0-1.0). Default varies by model. · Min: 0 · Max: 1
`strength`	number	Optional	Enhancement strength (0.01-1.0). Applies to Text Refine model only. · Min: 0.01 · Max: 1
`crop_to_fill`	boolean	Optional	Default: false
`output_format`	string	Optional	Output format of the upscaled image. · Options: jpeg, png · Default: "jpeg" jpegpng
`upscale_factor`	number	Optional	Factor to upscale the image by (e.g. 2.0 doubles width and height) · Min: 1 · Max: 4 · Default: 2
`fix_compression`	number	Optional	Compression artifact removal level (0.0-1.0). Not supported by the CGI model. · Min: 0 · Max: 1
`face_enhancement`	boolean	Optional	Whether to apply face enhancement to the image. · Default: true
`subject_detection`	string	Optional	Subject detection mode for the image enhancement. · Options: All, Foreground, Background · Default: "All" AllForegroundBackground
`face_enhancement_strength`	number	Optional	Strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled. · Min: 0 · Max: 1 · Default: 0.8
`face_enhancement_creativity`	number	Optional	Creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled. · Min: 0 · Max: 1 · Default: 0

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "Standard V2",
  "image": "https://static.sandbase.ai/examples/topaz/upscale/image/precision/input_image_0.jpeg",
  "crop_to_fill": false,
  "output_format": "jpeg",
  "upscale_factor": 2,
  "face_enhancement": true,
  "subject_detection": "All",
  "face_enhancement_strength": 0.8,
  "face_enhancement_creativity": 0,
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Topaz Upscale Image Precision

API README

Precision

Precision addresses the topaz/upscale/image/precision workflow for precision work in image production. The endpoint is especially useful when a project has a defined transformation goal and needs a repeatable request contract instead of an ad-hoc desktop step. Teams can place this named operation inside review, asset preparation, and publishing pipelines while keeping the original request attached to every result. Upscale Image Precision is Topaz Labs's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion. Because topaz/upscale/image/precision is a separate catalog entry, evaluations should use this route’s own inputs, output expectations, and billing behavior. Those strengths describe this precise catalog entry rather than its siblings.

image controls url of the image to be upscaled; strength controls enhancement strength (0.01-1.0). Applies to Text Refine model only; output format controls output format of the upscaled image; output format accepts jpeg, png; denoise controls denoising level (0.0-1.0). Default varies by model; face enhancement creativity controls creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled; face enhancement strength controls strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled; fix compression controls compression artifact removal level (0.0-1.0). Not supported by the CGI model. Precision exposes image, strength, output_format, denoise, face_enhancement_creativity, face_enhancement_strength, fix_compression as its documented request surface. For example, the route documentation includes “https://static.sandbase.ai/examples/topaz/upscale/image/precision/input_image_0.jpeg”. The mandatory portion is image. Applications can submit that exact shape asynchronously, retain the chosen arguments in job metadata, and collect the resulting media URL for review or publishing.

Highlights

Precision-first enlargement. Topaz Upscale Image Precision increases image dimensions while prioritizing faithful reconstruction of the supplied source.
Controlled detail recovery. The workflow strengthens edges and texture without treating stylistic reinvention as the primary objective.
Product and archival utility. It suits images where logos, geometry, faces, or documentary content should remain close to the original.
Production-size output. The result is prepared for higher-resolution layouts, review, and delivery with a conservative enhancement profile.

Pricing

Billing option	Price
Per request	`$0.08`

When to Use

Scenario	Why it fits
Choose Precision	Use it when the job specifically calls for precision and the route’s documented input contract matches assets already available in your workflow.
Keep the request reproducible	Use the required `image` explicitly, then record optional choices alongside the prompt for repeatable reruns.
Build controlled creative variations	Change one declared control at a time when comparing framing, format, duration, resolution, style, or other route-supported output decisions.
Integrate asynchronous delivery	Use this endpoint when an application can submit work, track completion, and collect the returned media URL instead of requiring an immediate inline artifact.
Validate before a large batch	Run representative prompts and source assets first, confirm the visual or audio behavior, then lock the successful request shape for scaled production.

Prompt Guide

Lead with the subject or transformation, then add the composition, environment, style, lighting, motion, voice, or fidelity details relevant to this route. Keep every parameter inside the documented schema; the example below uses only fields declared for topaz/upscale/image/precision.

{
  "image": "https://static.sandbase.ai/examples/topaz/upscale/image/precision/input_image_0.jpeg",
  "output_format": "jpeg",
  "subject_detection": "All",
  "model": "Standard V2"
}

Technical Specs

Specification	Details
Model ID	`topaz/upscale/image/precision`
Execution mode	`async`
Task type	`image`
`image`	`string` · required
`strength`	`number` · optional · min `0.01` · max `1`
`output_format`	`string` · optional · choices: `jpeg`, `png`
`denoise`	`number` · optional · min `0` · max `1`
`face_enhancement_creativity`	`number` · optional · min `0` · max `1`
`face_enhancement_strength`	`number` · optional · min `0` · max `1`
`fix_compression`	`number` · optional · min `0` · max `1`
`crop_to_fill`	`boolean` · optional
`upscale_factor`	`number` · optional · min `1` · max `4`
`face_enhancement`	`boolean` · optional
`subject_detection`	`string` · optional · choices: `All`, `Foreground`, `Background`
`sharpen`	`number` · optional · min `0` · max `1`
`model`	`string` · optional · choices: `Standard V2`, `High Fidelity V3`, `High Fidelity V2`, `Low Resolution V2`, `CGI`, `Text Refine`