# Topaz 图像增强

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

## 输入

### 通用输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|-----------|-------------|-----------|----------|-------|
| `image` | 要增强的输入图像。仅支持一个输入图像。 | IMAGE | 是 | 单张图像 |
| `model` | 要使用的 Topaz 增强模型。所选模型决定显示哪些模型特定设置。 | DYNAMIC_COMBO | 是 | `"Reimagine"`<br>`"Bloom 2"`<br>`"Wonder 3.5"`<br>`"Wonder 4"` |
| `output_width` | 零值表示自动计算（通常为原始尺寸；如果指定了 `output_height`，则按比例缩放到该高度）。Wonder 3.5 和 Wonder 4 支持 1x 到 6x 的放大倍数，Bloom 2 支持 1x 到 12x。Bloom 2、Wonder 3.5 和 Wonder 4 始终保持输入宽高比：如果同时设置两个尺寸且比例不同，较大的放大倍数会生效，输出会大于请求的尺寸，价格也会高于按请求尺寸计算的价格。 (默认: 0) | INT | 否 | 0 到 32000 |
| `output_height` | 零值表示输出高度与原始高度相同；如果指定了 `output_width`，则按比例缩放到该宽度。Wonder 3.5 和 Wonder 4 支持 1x 到 6x 的放大倍数，Bloom 2 支持 1x 到 12x。Bloom 2、Wonder 3.5 和 Wonder 4 始终保持输入宽高比：如果同时设置两个尺寸且比例不同，较大的放大倍数会生效，输出会大于请求的尺寸，价格也会高于按请求尺寸计算的价格。 (默认: 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 4 只提供通用输入。输出上限为 179 百万像素，单边不超过 32000 像素。

## 输出

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