> ## 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 使用 Topaz 模型对单张输入图像应用行业标准的放大和图像增强处理。它将图像发送到 Topaz API，使用所选模型进行处理，并返回增强后的结果。您可以从三种模型中选择：Reimagine、Bloom 2 和 Wonder 3.5。

## 输入

| 参数              | 描述                                                                                                                            | 数据类型   | 是否必需 | Range                                              |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------ | ---- | -------------------------------------------------- |
| `image`         | 要增强的输入图像。仅支持一张输入图像。                                                                                                           | IMAGE  | 是    | Single image                                       |
| `model`         | 要使用的 Topaz 增强模型。所选模型决定了显示哪些模型特定设置。                                                                                            | STRING | 是    | `"Reimagine"`<br />`"Bloom 2"`<br />`"Wonder 3.5"` |
| `output_width`  | 零值表示自动计算（通常为原始尺寸，或如果指定了 `output_height`，则按比例缩放）。Wonder 3.5 仅支持 1x 到 6x 的放大倍数。Bloom 2 和 Wonder 3.5 保持输入宽高比，并将请求的尺寸视为目标。（默认值：0） | INT    | 否    | 0 to 32000                                         |
| `output_height` | 零值表示输出与原始高度相同，或如果指定了 `output_width`，则按比例缩放。Wonder 3.5 仅支持 1x 到 6x 的放大倍数。Bloom 2 和 Wonder 3.5 保持输入宽高比，并将请求的尺寸视为目标。（默认值：0）      | INT    | 否    | 0 to 32000                                         |

### Reimagine 设置

当 `model` 设置为 `"Reimagine"` 时，这些设置适用。

| 参数                            | 描述                                                                 | 数据类型    | 是否必需 | Range                                           |
| ----------------------------- | ------------------------------------------------------------------ | ------- | ---- | ----------------------------------------------- |
| `prompt`                      | 用于创意放大引导的可选文本提示。（默认值：""）                                           | STRING  | 是    | Any text                                        |
| `creativity`                  | 增强的创意程度。（默认值：3）                                                    | INT     | 是    | 1 to 9                                          |
| `subject_detection`           | 主体检测模式。                                                            | STRING  | 是    | `"All"`<br />`"Foreground"`<br />`"Background"` |
| `face_enhancement`            | 在处理过程中增强面部（如果存在）。（默认值：True）                                        | BOOLEAN | 是    | true<br />false                                 |
| `face_enhancement_creativity` | 设置面部增强的创意程度。（默认值：0.0）                                              | FLOAT   | 是    | 0.0 to 1.0                                      |
| `face_enhancement_strength`   | 控制增强后脸部相对于背景的清晰程度。（默认值：1.0）                                        | FLOAT   | 是    | 0.0 to 1.0                                      |
| `face_preservation`           | 保持主体的面部身份特征。（默认值：True）                                             | BOOLEAN | 是    | true<br />false                                 |
| `color_preservation`          | 保持原始颜色。（默认值：True）                                                  | BOOLEAN | 是    | true<br />false                                 |
| `crop_to_fill`                | 默认情况下，当输出宽高比不同时，图像会以信箱格式（letterbox）显示。启用后，将裁剪图像以填充输出尺寸。（默认值：False） | BOOLEAN | 是    | true<br />false                                 |

### Bloom 2 设置

当 `model` 设置为 `"Bloom 2"` 时，这些设置适用。

| 参数                   | 描述                                  | 数据类型    | 是否必需 | Range                                      |
| -------------------- | ----------------------------------- | ------- | ---- | ------------------------------------------ |
| `prompt`             | 用于生成的可选文本提示。留空则从输入图像自动生成提示。（默认值：""） | STRING  | 是    | Any text                                   |
| `creativity`         | 1 为克制的增强，9 为带有新生成细节的显著重新诠释。（默认值：3）  | INT     | 是    | 1 to 9                                     |
| `seed`               | 用于可复现生成的种子。（默认值：2）                  | INT     | 是    | 1 to 2000                                  |
| `color_preservation` | 保持原始颜色。（默认值：True）                   | BOOLEAN | 是    | true<br />false                            |
| `grain`              | 向输出图像添加颗粒感。（默认值：False）              | BOOLEAN | 是    | true<br />false                            |
| `grain_model`        | 要使用的颗粒模型。如果禁用颗粒，则忽略此参数。             | STRING  | 是    | `"silver"`<br />`"gaussian"`<br />`"grey"` |
| `grain_strength`     | 颗粒效果的强度。如果禁用颗粒，则忽略此参数。（默认值：0.5）     | FLOAT   | 是    | 0.0 to 1.0                                 |
| `grain_size`         | 颗粒粒子的大小。如果禁用颗粒，则忽略此参数。（默认值：1.0）     | FLOAT   | 是    | 1.0 to 5.0                                 |
| `grain_density`      | 颗粒密度。如果禁用颗粒，则忽略此参数。（默认值：0.5）        | FLOAT   | 是    | 0.0 to 1.0                                 |

### Wonder 3.5 设置

当 `model` 设置为 `"Wonder 3.5"` 时，这些设置适用。

| 参数                     | 描述                              | 数据类型    | 是否必需 | Range                                      |
| ---------------------- | ------------------------------- | ------- | ---- | ------------------------------------------ |
| `enhancement_strength` | 针对不同输入条件的增强级别。（默认值："high"）      | STRING  | 是    | `"low"`<br />`"medium"`<br />`"high"`      |
| `grain`                | 向输出图像添加颗粒感。（默认值：False）          | BOOLEAN | 是    | true<br />false                            |
| `grain_model`          | 要使用的颗粒模型。如果禁用颗粒，则忽略此参数。         | STRING  | 是    | `"silver"`<br />`"gaussian"`<br />`"grey"` |
| `grain_strength`       | 颗粒效果的强度。如果禁用颗粒，则忽略此参数。（默认值：0.5） | FLOAT   | 是    | 0.0 to 1.0                                 |
| `grain_size`           | 颗粒粒子的大小。如果禁用颗粒，则忽略此参数。（默认值：1.0） | FLOAT   | 是    | 1.0 to 5.0                                 |
| `grain_density`        | 颗粒密度。如果禁用颗粒，则忽略此参数。（默认值：0.5）    | FLOAT   | 是    | 0.0 to 1.0                                 |

## 输出

| 输出名称    | 描述                        | 数据类型  |
| ------- | ------------------------- | ----- |
| `IMAGE` | 由 Topaz API 返回的增强并放大后的图像。 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TopazImageEnhanceV2/zh.md)

***

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