# Topaz Labs Topaz Upscale API

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

Source: https://www.sandbase.ai/models/topaz/upscale/image
API reference: https://www.sandbase.ai/models/topaz/upscale/image/docs

## Facts

- Provider: Topaz Labs
- Type: Image model
- Model ID: `topaz/upscale/image`
- Price: From $0.08 per run
- Capabilities: image to image
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "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
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

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

## README

### 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`.