> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# TopazImageEnhanceV2 - ComfyUI Built-in Node Documentation

> Complete documentation for the TopazImageEnhanceV2 node in ComfyUI. Learn its inputs, outputs, parameters and usage.

Topaz Image Enhance applies industry-standard upscaling and image enhancement to a single input image using Topaz models. It sends the image to the Topaz API, processes it with the selected model, and returns the enhanced result. You can choose from three models: Reimagine, Bloom 2, and Wonder 3.5.

## Inputs

| Parameter       | Description                                                                                                                                                                                                                                                                                                    | Data Type | Required | Range                                              |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | -------------------------------------------------- |
| `image`         | The input image to enhance. Only one input image is supported.                                                                                                                                                                                                                                                 | IMAGE     | Yes      | Single image                                       |
| `model`         | The Topaz enhancement model to use. The selected model determines which model-specific settings appear.                                                                                                                                                                                                        | STRING    | Yes      | `"Reimagine"`<br />`"Bloom 2"`<br />`"Wonder 3.5"` |
| `output_width`  | Zero value means to calculate automatically (usually it will be original size or scaled proportionally to `output_height` if specified). Wonder 3.5 supports upscale factors from 1x to 6x only. Bloom 2 and Wonder 3.5 preserve the input aspect ratio and treat the requested size as a target. (default: 0) | INT       | No       | 0 to 32000                                         |
| `output_height` | Zero value means to output in the same height as original or scaled proportionally to `output_width` if specified. Wonder 3.5 supports upscale factors from 1x to 6x only. Bloom 2 and Wonder 3.5 preserve the input aspect ratio and treat the requested size as a target. (default: 0)                       | INT       | No       | 0 to 32000                                         |

### Reimagine settings

These settings apply when `model` is set to `"Reimagine"`.

| Parameter                     | Description                                                                                                                                         | Data Type | Required | Range                                           |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ----------------------------------------------- |
| `prompt`                      | Optional text prompt for creative upscaling guidance. (default: "")                                                                                 | STRING    | Yes      | Any text                                        |
| `creativity`                  | Creativity level for the enhancement. (default: 3)                                                                                                  | INT       | Yes      | 1 to 9                                          |
| `subject_detection`           | Subject detection mode.                                                                                                                             | STRING    | Yes      | `"All"`<br />`"Foreground"`<br />`"Background"` |
| `face_enhancement`            | Enhance faces (if present) during processing. (default: True)                                                                                       | BOOLEAN   | Yes      | true<br />false                                 |
| `face_enhancement_creativity` | Set the creativity level for face enhancement. (default: 0.0)                                                                                       | FLOAT     | Yes      | 0.0 to 1.0                                      |
| `face_enhancement_strength`   | Controls how sharp enhanced faces are relative to the background. (default: 1.0)                                                                    | FLOAT     | Yes      | 0.0 to 1.0                                      |
| `face_preservation`           | Preserve subjects' facial identity. (default: True)                                                                                                 | BOOLEAN   | Yes      | true<br />false                                 |
| `color_preservation`          | Preserve the original colors. (default: True)                                                                                                       | BOOLEAN   | Yes      | true<br />false                                 |
| `crop_to_fill`                | By default, the image is letterboxed when the output aspect ratio differs. Enable to crop the image to fill the output dimensions. (default: False) | BOOLEAN   | Yes      | true<br />false                                 |

### Bloom 2 settings

These settings apply when `model` is set to `"Bloom 2"`.

| Parameter            | Description                                                                                                    | Data Type | Required | Range                                      |
| -------------------- | -------------------------------------------------------------------------------------------------------------- | --------- | -------- | ------------------------------------------ |
| `prompt`             | Optional text prompt for generation. Leave empty to auto-generate a prompt from the input image. (default: "") | STRING    | Yes      | Any text                                   |
| `creativity`         | 1 is restrained enhancement, 9 is pronounced reinterpretation with newly generated detail. (default: 3)        | INT       | Yes      | 1 to 9                                     |
| `seed`               | Seed for reproducible generation. (default: 2)                                                                 | INT       | Yes      | 1 to 2000                                  |
| `color_preservation` | Preserve the original colors. (default: True)                                                                  | BOOLEAN   | Yes      | true<br />false                            |
| `grain`              | Add grain to the output image. (default: False)                                                                | BOOLEAN   | Yes      | true<br />false                            |
| `grain_model`        | Grain model to use. Is ignored if grain is disabled.                                                           | STRING    | Yes      | `"silver"`<br />`"gaussian"`<br />`"grey"` |
| `grain_strength`     | Strength of the grain effect. Is ignored if grain is disabled. (default: 0.5)                                  | FLOAT     | Yes      | 0.0 to 1.0                                 |
| `grain_size`         | Size of the grain particles. Is ignored if grain is disabled. (default: 1.0)                                   | FLOAT     | Yes      | 1.0 to 5.0                                 |
| `grain_density`      | Intensity of the grain effect. Is ignored if grain is disabled. (default: 0.5)                                 | FLOAT     | Yes      | 0.0 to 1.0                                 |

### Wonder 3.5 settings

These settings apply when `model` is set to `"Wonder 3.5"`.

| Parameter              | Description                                                                    | Data Type | Required | Range                                      |
| ---------------------- | ------------------------------------------------------------------------------ | --------- | -------- | ------------------------------------------ |
| `enhancement_strength` | Enhancement level for varying input conditions. (default: "high")              | STRING    | Yes      | `"low"`<br />`"medium"`<br />`"high"`      |
| `grain`                | Add grain to the output image. (default: False)                                | BOOLEAN   | Yes      | true<br />false                            |
| `grain_model`          | Grain model to use. Is ignored if grain is disabled.                           | STRING    | Yes      | `"silver"`<br />`"gaussian"`<br />`"grey"` |
| `grain_strength`       | Strength of the grain effect. Is ignored if grain is disabled. (default: 0.5)  | FLOAT     | Yes      | 0.0 to 1.0                                 |
| `grain_size`           | Size of the grain particles. Is ignored if grain is disabled. (default: 1.0)   | FLOAT     | Yes      | 1.0 to 5.0                                 |
| `grain_density`        | Intensity of the grain effect. Is ignored if grain is disabled. (default: 0.5) | FLOAT     | Yes      | 0.0 to 1.0                                 |

## Outputs

| Output Name | Description                                                | Data Type |
| ----------- | ---------------------------------------------------------- | --------- |
| `IMAGE`     | The enhanced and upscaled image returned by the Topaz API. | IMAGE     |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TopazImageEnhanceV2/en.md)

***

**Source fingerprint (SHA-256):** `4301abb7cbab5122490b2ed3b328b199a29409da0dcc5ea5201570c2acbc2a58`