Topaz Labs Image Upscale

Topaz Labs image upscale is an industry-leading AI photo upscaler designed to increase the resolution of photos while preserving and enhancing fine details such as sharpness, and textures.

~22.72s
$0.375 per generation
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/topaz-image-upscale"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "image": "https://segmind-resources.s3.amazonaws.com/input/557ae4e3-8057-4668-bf41-ff836d0f73b0-test_upscale_1234142.jpg",
12    "enhance_model": "Standard V2",
13    "output_format": "jpg",
14    "upscale_factor": "2x",
15    "face_enhancement": false,
16    "face_enhancement_strength": 0.8,
17    "face_enhancement_creativity": 0
18}
19
20response = requests.post(url, headers=headers, json=data)
21
22if response.status_code == 200:
23    result = response.json()
24    print(json.dumps(result, indent=2))
25else:
26    print(f"Error: {response.status_code}")
27    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/topaz-image-upscale

Parameters

imagerequired
string (uri)

Upload the image you want to upscale — works best with JPEGs or PNGs of portraits, products, or film frames.

Default: "https://segmind-resources.s3.amazonaws.com/input/557ae4e3-8057-4668-bf41-ff836d0f73b0-test_upscale_1234142.jpg"
enhance_modeloptional
string

Choose the enhancement type: Standard V2 for general use, High Fidelity V2 for detail-rich images, CGI for digital art.

Default: "Standard V2"
Allowed values :
"Standard V2""Low Resolution V2""CGI""High Fidelity V2""Text Refine"
face_enhancementoptional
boolean

Toggle to true if faces are present, great for portraits, character renders, and people in videos.

Default: false
face_enhancement_creativityoptional
number

Control artistic liberty in face enhancements, use 0 for realism, higher values for stylized or expressive looks.

Default: 0Range: 0 - 1
face_enhancement_strengthoptional
number

Set how sharp faces appear (0–1); 0.8 is ideal for natural skin textures, 1.0 for hyper-sharp details.

Default: 0.8Range: 0 - 1
output_formatoptional
string

Pick jpg for compression or png for lossless quality, PNG is better for sharp edges and transparency.

Default: "jpg"
Allowed values :
"jpg""png"
subject_detectionoptional
string

Focus enhancement on Foreground, Background, or All, use Foreground for products or portraits.

Allowed values :
"None""All""Foreground""Background"
upscale_factoroptional
string

Select 2x, 4x, or 6x to boost resolution — ideal for printing, zoom-ins, or turning 720p into 4K.

Allowed values :
"None""2x""4x""6x"

Response Type

Returns: Image

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out