# Recover 3

### Model Overview

**Recover 3** is a generative image recovery model designed to reconstruct missing detail in low-resolution, damaged, or out-of-focus images, with a particular strength in restoring realistic facial features and natural textures. Now in its third generation, Recover 3 delivers significantly improved detail reconstruction, texture fidelity, and realism compared to earlier versions.

Recover intelligently rebuilds hair, skin, fabric, foliage, and other organic detail where original image information is limited or lost. It is especially effective for old photographs, heavily compressed images, and small or blurry faces, producing results that feel photographic rather than artificial.

### Key Capabilities

* Reconstructs missing facial features and fine textures with improved realism and stability over earlier Recover models.
* Prioritizes believable skin, hair, and material textures while avoiding over-sharpened or plastic artifacts.
* Realistic and Creative recovery options to balance fidelity versus detail generation, depending on source quality.

### 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>
  * `model` — `"Recover 3"` or `"Natural Enhance"`

<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`: float, `0.0` <= x <= `10.0`, default = `5.0`

**Resolution Limits**

* `input` — 24 MP
* `output` — 384 MP

### Examples

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Click to view</td><td><a href="https://4007072434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJkSwaYgAsTQke14gpXAF%2Fuploads%2FvRLzvnBPMlTOFNle90E3%2FRecover_3_(Ex_1)_slider.jpg?alt=media&#x26;token=bcc3eb1b-1493-491e-a0b7-7aa16b0bea0a">Recover_3_(Ex_1)_slider.jpg</a></td><td><a href="https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FArchival-before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FArchival-after-gigapixel-recover%20v3-4x-faceai%20v2.jpg&#x26;src2label=After&#x26;zoom=1">https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FArchival-before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FArchival-after-gigapixel-recover%20v3-4x-faceai%20v2.jpg&#x26;src2label=After&#x26;zoom=1</a></td></tr><tr><td align="center">Click to view</td><td><a href="https://4007072434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJkSwaYgAsTQke14gpXAF%2Fuploads%2FLHsGULWOVS81L7X8IyiI%2FRecover_3_(Ex_2)_slider.jpg?alt=media&#x26;token=4a0fcdb6-20de-4b11-b22b-4a8fbc74c947">Recover_3_(Ex_2)_slider.jpg</a></td><td><a href="https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FRecover%20with%20Face%20Recover%20Before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FRecover%20with%20Face%20Recover%2002.jpg&#x26;src2label=After&#x26;zoom=1">https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FRecover%20with%20Face%20Recover%20Before.jpg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FRecover%20with%20Face%20Recover%2002.jpg&#x26;src2label=After&#x26;zoom=1</a></td></tr></tbody></table>
