# Wonder 3

### Model Overview

**Wonder 3** is an updated generative upscaling model designed to deliver significantly higher quality results with more natural detail and improved realism across a wide range of image types. It supports both high-quality inputs and heavily degraded or compressed images, with selectable Low, Medium, and High enhancement levels for greater control across varying input conditions.

Wonder 3 performs across all resolution levels and is well suited for portraits, landscapes, wildlife, and complex textures such as fabrics, metallics, feathers, and skin. It also improves on Wonder 2 by resolving challenging edge cases and reducing the plasticky appearance and artifacts seen in earlier versions.

### Key Capabilities

* Higher quality results with more natural detail and improved realism.
* Handles both high-quality inputs and heavily degraded images with consistent performance.
* Preserves text, logos, and fine details when source quality allows. 
* Multi-level enhancement control for adjusting strength across a range of input conditions.

### Model Pricing

<table data-header-hidden data-full-width="false"><thead><tr><th width="119.84765625">Text</th><th width="60.390625" data-type="number">Number</th><th width="59.5390625" data-type="number"></th><th width="60.0859375" data-type="number"></th><th width="60.265625" data-type="number"></th><th width="59.94140625" data-type="number"></th><th width="59.5390625" data-type="number"></th><th width="60.34375" data-type="number"></th><th width="59.9296875" data-type="number"></th><th width="59.828125" data-type="number"></th><th width="59.5078125" data-type="number"></th></tr></thead><tbody><tr><td><code>Output MP</code></td><td>1</td><td>4</td><td>8</td><td>16</td><td>24</td><td>32</td><td>40</td><td>50</td><td>64</td><td>100</td></tr><tr><td><code>Credits</code></td><td>1</td><td>1</td><td>2</td><td>4</td><td>6</td><td>8</td><td>10</td><td>13</td><td>16</td><td>25</td></tr></tbody></table>

### Getting Started

**Endpoint**

* [https://api.topazlabs.com/image/v1/enhance-gen/async](<https://api.topazlabs.com/image/v1/enhance-gen/async&#xA;&#xA;>)
  * `model` — `"Wonder 3"`

<details>

<summary><strong>Endpoint-Specific Parameters</strong></summary>

* `face_enhancement` — boolean
  * Leverages our face recovery model to enhance faces.
* `face_enhancement_strength` — decimal between 0 and 1 *(required if `face_enhancement=true`)*
  * Sets the strength of the face recovery.
* `face_enhancement_creativity` — decimal between 0 and 1 *(required if `face_enhancement=true`)*
  * Choose realistic or creative face recovery.
* `subject_detection` — `"foreground"`, `"background"`, or `"all"`
  * Choose where enhancements are applied.
* `prompt` — string, default `""`; max 1024 char
  * A description of the resulting image you are looking for. **The model responds more to a descriptive statement versus a directive one**. For example, use the phrase "girl with red hair and blue eyes" instead of "change the girl's hair to red and make her eyes blue"
* `autoprompt` — boolean *(if enabled, ignores value given to `prompt`)*
  * Whether you want to use our state-of-the-art auto-prompting model to auto-generate a prompt for you.
* `creativity` — integer between 1 and 9, default 3
  * Lower creativity values maintain the highest fidelity to the original image. Higher values take more liberties and provide more creative results for specific details.
* `texture` — integer between 1 and 5 *(recommend 1 at low creativity, 3 at higher creativity)*
  * Add texture to the image. Recommend setting texture to 1 for at a low creativity level, and 3 for more creative results at a higher creativity level.
* `sharpen` — decimal between 0 and 1
  * Slightly sharpens the image.
* `denoise` — decimal between 0 and 1
  * Reduces noise in the image.
* `detail` — boolean, default `false`
  * Adjusts the level of added detail after rendering.
* `detail_strength` — decimal between 0 and 10 *(required if `detail=true`)*
  * Sets the strength of the detail.

These parameters should be appended as key-value fields in the form-data request bodies (i.e. alongside the `model`, `output_height`, and `face_enhancement` etc. fields). Any parameters not explicitly provided are **automatically** configured by our auto-parameter model. Extra parameters provided that are not supported are ignored.

</details>

**Model-Specific Parameters**

* `enhancement_strength` — `"high"`, `"medium"` , `"low"`

### Examples

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td align="center">Click to view</td><td><a href="https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fbird_wonder3_before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fbird_wonder3_after.jpg&#x26;src2label=After&#x26;zoom=1.0">https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fbird_wonder3_before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fbird_wonder3_after.jpg&#x26;src2label=After&#x26;zoom=1.0</a></td><td><a href="/files/cFBYtnM9d67ZuCjyv3Lc">/files/cFBYtnM9d67ZuCjyv3Lc</a></td></tr><tr><td align="center">Click to view</td><td><a href="https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fperson_wonder3_before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fperson_wonder3_after.jpg&#x26;src2label=After&#x26;zoom=1.0">https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fperson_wonder3_before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fperson_wonder3_after.jpg&#x26;src2label=After&#x26;zoom=1.0</a></td><td><a href="/files/H7YiwrvKmK3QHWuSs5tj">/files/H7YiwrvKmK3QHWuSs5tj</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.topazlabs.com/image-models/wonder/wonder-3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.