# Topaz Upscale — Image

> Use the powerful and accurate topaz image enhancer to enhance your images.

## Overview

- **Endpoint**: `https://api.runflow.io/v1/run/topaz/upscale/image`
- **Model ID**: `topaz/upscale/image`
- **Provider**: Topaz Labs
- **License**: commercial
- **Last Updated**: 2026-04-08

## Pricing

- **Base price**: $0.01/megapixel
- **Note**: Default price
## Input Schema

### `prompt` (string, optional)

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

### `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.
- **Default**: `0`
- **Min**: 0
- **Max**: 1

### `face_enhancement` (boolean, optional)

Whether to apply face enhancement to the image. Applies to standard enhance and Recovery V2 models.
- **Default**: `true`

### `model` (string, optional)

Model to use for image enhancement.
- **Default**: `Standard V2`
- **Options**: `Low Resolution V2`, `Standard V2`, `CGI`, `High Fidelity V2`, `Text Refine`, `Recovery`, `Redefine`, `Recovery V2`, `Standard MAX`, `Wonder`

### `crop_to_fill` (boolean, optional)


- **Default**: `false`

### `upscale_factor` (number, optional)

Factor to upscale the image by (e.g. 2.0 doubles width and height)
- **Default**: `2`
- **Min**: 1
- **Max**: 4

### `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.
- **Default**: `0.8`
- **Min**: 0
- **Max**: 1

### `sharpen` (number, optional)

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

### `detail` (number, optional)

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

### `denoise` (number, optional)

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

### `output_format` (string, optional)

Output format of the upscaled image.
- **Default**: `jpeg`
- **Options**: `jpeg`, `png`

### `subject_detection` (string, optional)

Subject detection mode for the image enhancement. Applies to standard enhance and Recovery V2 models.
- **Default**: `All`
- **Options**: `All`, `Foreground`, `Background`

### `strength` (number, optional)

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

### `texture` (integer, optional)

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

### `image_url` (image, required)

Url of the image to be upscaled

### `autoprompt` (boolean, optional)

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

### `creativity` (integer, optional)

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

### `fix_compression` (number, optional)

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

## Usage Examples

### cURL

```bash
curl -X POST https://api.runflow.io/v1/run/topaz/upscale/image \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A professional headshot, soft studio lighting",
    "image_url": "https://example.com/input.jpg",
    "output_format": "png"
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://api.runflow.io/v1/run/topaz/upscale/image",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "prompt": "A professional headshot, soft studio lighting",
        "image_url": "https://example.com/input.jpg",
        "output_format": "png",
    },
)

data = response.json()
print(data["image"]["url"])
```

### JavaScript

```javascript
const response = await fetch(
  "https://api.runflow.io/v1/run/topaz/upscale/image",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt: "A professional headshot, soft studio lighting",
      image_url: "https://example.com/input.jpg",
      output_format: "png",
    }),
  }
);

const data = await response.json();
console.log(data.image.url);
```

## Additional Resources

- [Playground](https://www.runflow.io/models/topaz/upscale/image)
- [API Reference](https://www.runflow.io/models/topaz/upscale/image/api)
- [Documentation](https://www.runflow.io/docs)