Skip to content

Topaz Upscale Image Generative

Integrate

Model id topaz/upscale/image/generative
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.08 80 API credits your files are measured before the run Run it on this page

Get API key
Topaz Labs Upscale #upscale#image

Generative image upscaler with many models, face enhancement and prompt-guided Redefine mode

Topaz Labs · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

0 / 1024

Guidance text for generative upscaling, limited to 1024 characters and supported only by Redefine.

•required image_url
Drop a file, or

Source image URL for upscaling.

default Wonder 3

Generative upscaling model selection: Recovery and Recovery V2 reconstruct extremely low-resolution images; Redefine uses prompts to guide creative detail; Standard MAX favors precision and high quality; Recover 3 reconstructs natural detail. Within the Wonder family, Wonder and Wonder 2 precede Wonder 3, the most advanced generative realism model; the newest release, Wonder 3.5, provides finer detail with less pattern repetition.

default 2

Image enlargement multiplier; for example, 2.0 doubles both dimensions.

Advanced output_format · subject_detection · enhancement_strength · face_enhancement_creativity · face_enhancement_strength · creativity · texture · sharpen · denoise · detail · crop_to_fill · face_enhancement · autoprompt · enable_safety_checker
output_format default jpeg

Format used for the upscaled image.

subject_detection default All

Controls how subjects are detected when enhancing images with Recovery V2, Wonder 3 or Recovery.

enhancement_strength

Generative-upscaling enhancement strength, automatically configured if left unspecified; supported models are Wonder 3.5 and Wonder 3.

default 0

Face-enhancement creativity control, active only while face enhancement is enabled: set 1.0 for maximum creativity or 0.0 for none.

default 0.8

Face-enhancement strength control, active only while face enhancement is enabled: set 1.0 for maximum enhancement or 0.0 for none.

Generative upscaling creativity from 1 to 6, supported only by Redefine. Increasing it adds more imaginative or hallucinated detail.

Texture-detail control exclusive to Redefine's generative upscaling, accepting levels from 1 to 5.

Sharpening intensity from 0.0 to 1.0, supported only by Redefine.

Denoising intensity from 0.0 to 1.0, supported only by Redefine.

Detail recovery intensity from 0.0 to 1.0, supported only by Recovery V2.

POST /run/topaz/upscale/image/generative?wait=20 quote → $0.08
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Topaz Upscale Image Generative

Upscales an image 1x to 4x with a choice of `model`, including Wonder 3.5, Wonder 3, Recover 3, Redefine and Recovery V2. Face enhancement has its own strength and creativity sliders. Redefine adds a `prompt` up to 1024 characters plus `creativity`, `texture`, `sharpen` and `denoise`. Good for small or blurry sources.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Source image URL for upscaling.
modeloptional
Typeenum
DefaultWonder 3
Wonder 3.5Wonder 3Wonder 2WonderRecover 3Standard MAXRedefineRecovery V2Recovery
Generative upscaling model selection: Recovery and Recovery V2 reconstruct extremely low-resolution images; Redefine uses prompts to guide creative detail; Standard MAX favors precision and high quality; Recover 3 reconstructs natural detail. Within the Wonder family, Wonder and Wonder 2 precede Wonder 3, the most advanced generative realism model; the newest release, Wonder 3.5, provides finer detail with less pattern repetition.
upscale_factoroptional
Typenumber
Default2
1 – 4
Image enlargement multiplier; for example, 2.0 doubles both dimensions.
crop_to_filloptional
Typeboolean
Defaultfalse
output_formatoptional
Typeenum
Defaultjpeg
jpegpng
Format used for the upscaled image.
subject_detectionoptional
Typeenum
DefaultAll
AllForegroundBackground
Controls how subjects are detected when enhancing images with Recovery V2, Wonder 3 or Recovery.
face_enhancementoptional
Typeboolean
Defaulttrue
Face enhancement toggle for the image.
face_enhancement_creativityoptional
Typenumber
Default0
0 – 1
Face-enhancement creativity control, active only while face enhancement is enabled: set 1.0 for maximum creativity or 0.0 for none.
face_enhancement_strengthoptional
Typenumber
Default0.8
0 – 1
Face-enhancement strength control, active only while face enhancement is enabled: set 1.0 for maximum enhancement or 0.0 for none.
enhancement_strengthoptional
Typeenum
lowmediumhigh
Generative-upscaling enhancement strength, automatically configured if left unspecified; supported models are Wonder 3.5 and Wonder 3.
creativityoptional
Typeinteger | null
1 – 6
Generative upscaling creativity from 1 to 6, supported only by Redefine. Increasing it adds more imaginative or hallucinated detail.
textureoptional
Typeinteger | null
1 – 5
Texture-detail control exclusive to Redefine's generative upscaling, accepting levels from 1 to 5.
promptoptional
Typestring | null
≤ 1,024 characters
Guidance text for generative upscaling, limited to 1024 characters and supported only by Redefine.
autopromptoptional
Typeboolean | null
Automatic prompt generation toggle available exclusively within Redefine's generative upscaling.
sharpenoptional
Typenumber | null
0 – 1
Sharpening intensity from 0.0 to 1.0, supported only by Redefine.
denoiseoptional
Typenumber | null
0 – 1
Denoising intensity from 0.0 to 1.0, supported only by Redefine.
detailoptional
Typenumber | null
0 – 1
Detail recovery intensity from 0.0 to 1.0, supported only by Recovery V2.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "topaz/upscale/image/generative",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 80,
    "usd": "0.08",
    "charged": 80,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
image
object {url, content_type, file_name, file_size}Image produced by upscaling.

More models: Upscale

For AI agents: this page as Markdown is at https://doitong.com/developers/models/topaz/upscale/image/generative.md. All models and guides: https://doitong.com/developers/llms.txt