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

# TopazImageEnhanceV2 - ComfyUI Built-in Node Documentation

> Topaz Image Enhance 使用 Topaz 模型对单张输入图像应用行业标准的放大和图像增强。

Topaz Image Enhance 使用 Topaz 模型对单张输入图像应用行业标准的放大和图像增强。它将图像发送到 Topaz API，使用所选模型进行处理，并返回增强结果。你可以选择三种模型：Reimagine、Bloom 2 和 Wonder 3.5。

## 输入

### 通用输入

| 参数              | 描述                                                                                                                                 | 数据类型           | 必需 | 范围                                                 |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------- | -- | -------------------------------------------------- |
| `image`         | 要增强的输入图像。仅支持一个输入图像。                                                                                                                | IMAGE          | 是  | 单张图像                                               |
| `model`         | 要使用的 Topaz 增强模型。所选模型决定显示哪些模型特定设置。                                                                                                  | DYNAMIC\_COMBO | 是  | `"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 到 32000                                          |
| `output_height` | 零值表示输出高度与原始高度相同；如果指定了 `output_width`，则按比例缩放到该宽度。Wonder 3.5 仅支持 1x 到 6x 的放大倍数。Bloom 2 和 Wonder 3.5 会保持输入宽高比，并将请求的尺寸视为目标。 (默认: 0)    | INT            | 否  | 0 到 32000                                          |

### Reimagine 输入

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

| 参数                            | 描述                                                        | 数据类型    | 必需 | 范围                                              |
| ----------------------------- | --------------------------------------------------------- | ------- | -- | ----------------------------------------------- |
| `prompt`                      | 用于创意放大指导的可选文本提示。 (默认: "")                                 | STRING  | 是  | 任意文本                                            |
| `creativity`                  | 增强的创意程度。 (默认: 3)                                          | INT     | 是  | 1 到 9                                           |
| `subject_detection`           | 主体检测模式（高级）。                                               | COMBO   | 是  | `"All"`<br />`"Foreground"`<br />`"Background"` |
| `face_enhancement`            | 在处理过程中增强人脸（如果存在）。 (默认: True)                              | BOOLEAN | 是  | true<br />false                                 |
| `face_enhancement_creativity` | 设置人脸增强的创意程度。 (默认: 0.0)                                    | FLOAT   | 是  | 0.0 到 1.0                                       |
| `face_enhancement_strength`   | 控制增强后的人脸相对于背景的锐利程度。 (默认: 1.0)                             | FLOAT   | 是  | 0.0 到 1.0                                       |
| `face_preservation`           | 保留人物的面部身份特征。 (默认: True)                                   | BOOLEAN | 是  | true<br />false                                 |
| `color_preservation`          | 保留原始颜色。 (默认: True)                                        | BOOLEAN | 是  | true<br />false                                 |
| `crop_to_fill`                | 默认情况下，当输出宽高比不同时，图像会以信箱模式添加黑边。启用后将裁剪图像以填满输出尺寸。 (默认: False) | BOOLEAN | 是  | true<br />false                                 |

### Bloom 2 输入

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

| 参数                   | 描述                                    | 数据类型    | 必需 | 范围                                         |
| -------------------- | ------------------------------------- | ------- | -- | ------------------------------------------ |
| `prompt`             | 用于生成的可选文本提示。留空则根据输入图像自动生成提示。 (默认: "") | STRING  | 是  | 任意文本                                       |
| `creativity`         | 1 表示克制增强，9 表示明显重新诠释并生成新细节。 (默认: 3)    | INT     | 是  | 1 到 9                                      |
| `seed`               | 用于可重复生成的种子。 (默认: 2)                   | INT     | 是  | 1 到 2000                                   |
| `color_preservation` | 保留原始颜色。 (默认: True)                    | BOOLEAN | 是  | true<br />false                            |
| `grain`              | 为输出图像添加颗粒。 (默认: False)                | BOOLEAN | 是  | true<br />false                            |
| `grain_model`        | 要使用的颗粒模型。如果禁用颗粒，则忽略此项。                | COMBO   | 是  | `"silver"`<br />`"gaussian"`<br />`"grey"` |
| `grain_strength`     | 颗粒效果的强度。如果禁用颗粒，则忽略此项。 (默认: 0.5)       | FLOAT   | 是  | 0.0 到 1.0                                  |
| `grain_size`         | 颗粒大小。如果禁用颗粒，则忽略此项。 (默认: 1.0)          | FLOAT   | 是  | 1.0 到 5.0                                  |
| `grain_density`      | 颗粒效果的密度。如果禁用颗粒，则忽略此项。 (默认: 0.5)       | FLOAT   | 是  | 0.0 到 1.0                                  |

### Wonder 3.5 输入

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

| 参数                     | 描述                              | 数据类型    | 必需 | 范围                                         |
| ---------------------- | ------------------------------- | ------- | -- | ------------------------------------------ |
| `enhancement_strength` | 用于不同输入条件的增强级别。 (默认: "high")     | COMBO   | 是  | `"low"`<br />`"medium"`<br />`"high"`      |
| `grain`                | 为输出图像添加颗粒。 (默认: False)          | BOOLEAN | 是  | true<br />false                            |
| `grain_model`          | 要使用的颗粒模型。如果禁用颗粒，则忽略此项。          | COMBO   | 是  | `"silver"`<br />`"gaussian"`<br />`"grey"` |
| `grain_strength`       | 颗粒效果的强度。如果禁用颗粒，则忽略此项。 (默认: 0.5) | FLOAT   | 是  | 0.0 到 1.0                                  |
| `grain_size`           | 颗粒大小。如果禁用颗粒，则忽略此项。 (默认: 1.0)    | FLOAT   | 是  | 1.0 到 5.0                                  |
| `grain_density`        | 颗粒效果的密度。如果禁用颗粒，则忽略此项。 (默认: 0.5) | FLOAT   | 是  | 0.0 到 1.0                                  |

**注意：** 仅支持一个输入图像；如果输入批次包含多张图像，该节点会报错。除非启用了 `grain`，否则会忽略颗粒设置（`grain_model`、`grain_strength`、`grain_size`、`grain_density`）。对于 Bloom 2，将 `prompt` 留空会自动根据输入图像生成提示。Wonder 3.5 仅支持 1x 到 6x 的放大倍数；Bloom 2 和 Wonder 3.5 会保持输入宽高比，并将请求的尺寸视为目标。

## 输出

| 输出名称    | 描述                      | 数据类型  |
| ------- | ----------------------- | ----- |
| `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):** `19bb03ca7354f1b0d1e559b742b83939678fce6d5f490b1030717b846043e0e6`