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

# TopazImageEnhance - ComfyUI Built-in Node Documentation

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

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

Topaz Image Enhance 节点提供行业标准的图像放大和增强功能。它通过基于云的 AI 模型处理单个输入图像，以提升画质、细节和分辨率。该节点提供对增强过程的精细控制，包括创意引导、主体聚焦和面部保留等选项。

## 输入参数

| 参数                            | 数据类型    | 必填 | 取值范围                                            | 描述                                                        |
| ----------------------------- | ------- | -- | ----------------------------------------------- | --------------------------------------------------------- |
| `model`                       | COMBO   | 是  | `"Reimagine"`                                   | 用于图像增强的 AI 模型。                                            |
| `image`                       | IMAGE   | 是  | -                                               | 待增强的输入图像。仅支持单张图像。                                         |
| `prompt`                      | STRING  | 否  | -                                               | 用于创意放大引导的可选文本提示（默认：空）。                                    |
| `subject_detection`           | COMBO   | 否  | `"All"`<br />`"Foreground"`<br />`"Background"` | 控制增强过程聚焦于图像的哪个部分（默认："All"）。                               |
| `face_enhancement`            | BOOLEAN | 否  | -                                               | 启用后，如果图像中存在人脸，则对其进行增强（默认：True）。                           |
| `face_enhancement_creativity` | FLOAT   | 否  | 0.0 - 1.0                                       | 设置人脸增强的创意级别（默认：0.0）。                                      |
| `face_enhancement_strength`   | FLOAT   | 否  | 0.0 - 1.0                                       | 控制增强后的人脸相对于背景的锐利程度（默认：1.0）。                               |
| `crop_to_fill`                | BOOLEAN | 否  | -                                               | 默认情况下，当输出宽高比不同时，图像会添加黑边。启用此选项将裁剪图像以填充输出尺寸（默认：False）。      |
| `output_width`                | INT     | 否  | 0 - 32000                                       | 输出图像的期望宽度。值为 0 表示自动计算，通常基于原始尺寸或指定的 `output_height`（默认：0）。 |
| `output_height`               | INT     | 否  | 0 - 32000                                       | 输出图像的期望高度。值为 0 表示自动计算，通常基于原始尺寸或指定的 `output_width`（默认：0）。  |
| `creativity`                  | INT     | 否  | 1 - 9                                           | 控制增强的整体创意级别（默认：3）。                                        |
| `face_preservation`           | BOOLEAN | 否  | -                                               | 保留图像中人物的面部特征（默认：True）。                                    |
| `color_preservation`          | BOOLEAN | 否  | -                                               | 保留输入图像的原始颜色（默认：True）。                                     |

**注意：** 此节点只能处理单张输入图像。提供包含多张图像的批次将导致错误。

## 输出

| 输出名称    | 数据类型  | 描述        |
| ------- | ----- | --------- |
| `image` | IMAGE | 增强后的输出图像。 |