Skip to main content
Core.Today
|
Topaz LabsMediumUltra

Topaz Image Upscale

Professional-grade upscaling from Topaz Labs, the industry standard for photo enhancement. Five specialized enhance models, up to 6x upscale, subject detection, and optional face enhancement.

190 credits
per image
Industry-standard Topaz enhancement quality
5 enhance models: Standard / Low Resolution / CGI / High Fidelity / Text Refine
Up to 6x upscale
Subject detection (foreground/background)
Face enhancement with strength/creativity control

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "topazlabs/image-upscale",
  "input": {
    "image": "https://example.com/photo.jpg",
    "enhance_model": "High Fidelity V2",
    "upscale_factor": "4x",
    "face_enhancement": true
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
imagestringYes-Image to enhance
enhance_modelstringNoStandard V2Standard V2 (general), Low Resolution V2 (low-res sources), CGI (digital art), High Fidelity V2 (detail-preserving), Text Refine (text-heavy)
Standard V2Low Resolution V2CGIHigh Fidelity V2Text Refine
upscale_factorstringNoNoneHow much to upscale ('None' enhances without enlarging)
None2x4x6x
output_formatstringNojpgOutput format
jpgpng
subject_detectionstringNoNoneRestrict enhancement to detected subjects
NoneAllForegroundBackground
face_enhancementbooleanNofalseEnhance faces in the image
face_enhancement_creativitynumberNo0Choose the level of creativity for face enhancement from 0 to 1. Defaults to 0, and is ignored if face_enhancement is false.
face_enhancement_strengthnumberNo0.8Control how sharp the enhanced faces are relative to the background from 0 to 1. Defaults to 0.8, and is ignored if face_enhancement is false.

How to Provide File Input

There are 3 ways to provide files for the image parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=topazlabs/image-upscale" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "topazlabs/image-upscale",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}
See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Professional 4x Enlargement

High-fidelity 4x upscale for print

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "topazlabs/image-upscale",
  "input": {
    "image": "https://example.com/photo.jpg",
    "enhance_model": "High Fidelity V2",
    "upscale_factor": "4x",
    "face_enhancement": true
  }
}'

Tips & Best Practices

1Pick the enhance model by source: Low Resolution V2 for web-res images, CGI for renders, Text Refine for documents
2upscale_factor 'None' runs enhancement only โ€” useful to clean up before other edits
3The premium price buys Topaz's commercial-grade quality โ€” use cheaper Real-ESRGAN for drafts
4face_enhancement has separate strength/creativity dials via API

Use Cases

Professional photography enlargement
Commercial print preparation
CGI and digital art enhancement
Text-heavy document image refinement
High-end client deliverables