> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.