> ## 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.

# Topaz Image Enhance Wonder 4 - AI 图像放大

> 在 ComfyUI 中使用 Topaz Image Enhance Wonder 4 放大模糊、压缩的图像：以目标尺寸单次重建合理细节，而不是拉伸像素

Topaz Image Enhance Wonder 4 是一款图像放大模型，可通过 Topaz 合作节点在 ComfyUI 中使用。它会重建合理的细节，而不是拉伸像素，因此小尺寸、模糊的图像最高可放大到 6 倍并恢复干净。该模型保留输入的长宽比，并支持从 1x 至 6x 的放大倍数。

## Topaz Image Enhance Wonder 4 擅长什么

* **细节重建**：在模糊或压缩的图像中重建合理细节，而不是插值像素
* **单次处理**：以目标尺寸单次完成，无需调整强度或颗粒设置
* **修复小尺寸来源**：适用于老旧扫描件、截图、AI 缩略图和手机裁剪图
* **灵活的输出**：保留输入图像的宽高比，支持从 1x 至 6x 的放大倍数

> [!TIP]
>
> 使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](https://docs.comfy.org/zh/tutorials/partner-nodes/overview.md)部分文档来了解使用 API 节点的具体使用要求。

> [!TIP]
>
> > [tab] 本地用户
> >
> > 请确保你的 ComfyUI 已经更新。
> >
> > * [ComfyUI 下载](https://www.comfy.org/download)
> > * [ComfyUI 更新教程](https://docs.comfy.org/zh/installation/update_comfyui.md)
> >
> > 本指南里的工作流可以在[工作流模板](https://docs.comfy.org/zh/interface/features/template.md)中找到。如果找不到，可能是 ComfyUI 没有更新。
> >
> > 如果加载工作流时有节点缺失，可能原因有：
> >
> > 1. 你用的不是最新版（每夜版）。
> > 2. 启动时有些节点导入失败。
>
> > [tab] 云端用户
> >
> > * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。
> >
> > 所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。

## Topaz 图像增强 Wonder 4

使用 Wonder 4 对单张图像进行放大，它会在目标尺寸上单次重建细节。该工作流接收 1 张输入图像，输出 1 个放大结果，并同时生成并排对比图。

![Topaz 图像增强 Wonder 4 工作流预览](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_topaz_image_enhance_wonder4-1.webp)

> [card] [在 Comfy Cloud 上运行](https://cloud.comfy.org/?template=api_topaz_image_enhance_wonder4\&utm_source=docs\&utm_medium=referral\&utm_campaign=topaz-image-enhance-wonder-4)
>
> 在 Comfy Cloud 中打开

> [card] [下载工作流](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_topaz_image_enhance_wonder4.json)
>
> 下载 JSON，或在模板库中搜索“Image Upscale: Topaz Wonder 4”

<details>
  <summary>输入素材</summary>

  下载此示例输入图像以试用该工作流。它是 1024 × 1024 纸艺拼贴图像的 512 × 512 轻压缩副本：

  > [card] [输入图像：topaz\_wonder4\_collage\_lowres.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/topaz_wonder4_collage_lowres.png)
  >
  > 下载示例输入图像
</details>

### 控件

| 控件 | 作用 |
| - | - |
| `model` | 设为 `Wonder 4`。`Wonder 3.5` 和 `Bloom 2` 会附带各自的设置，例如增强强度或提示词 |
| `scale_by` | 位于 **ImageScaleBy** 节点：放大倍数。Wonder 4 支持 1x 至 6x；Bloom 2 最高 12x |
| `output_width` / `output_height` | 位于 **TopazImageEnhanceV2** 节点：目标像素尺寸，本工作流由 **GetImageSize** 填入。两者都设为 0 时自动决定输出尺寸 |
| `filename_prefix` | 位于 **SaveImageAdvanced** 节点：输出文件名前缀 |

Wonder 4 保留来源图像的宽高比：当请求的宽度与高度不一致时，较大的倍数生效，输出会比请求的尺寸更大。输出上限为 179 兆像素，且每边不超过 32,000 像素；节点在发送前会将输入缩小到约 16 兆像素。

### 运行步骤

1. **加载图像**：在 **LoadImage** 节点中上传或选择你的输入图像
2. **选择模型**：在 **TopazImageEnhanceV2** 节点上保持 `Wonder 4`
3. **设置目标尺寸**：修改 **ImageScaleBy** 节点上的 `scale_by`，范围为 1x 至 6x
4. **可选覆盖**：在节点的 `output_width` 或 `output_height` 中输入像素尺寸（两者都设为 0 则保持自动尺寸）
5. **点击“队列”**：按 `Ctrl+Enter` 生成

## 何时使用

对于小尺寸、中等尺寸、模糊、有噪波或经过压缩的图像，优先使用 Wonder 4：老旧扫描件、截图、AI 缩略图和手机裁剪图。带图形与纹理的图像是很好的测试对象，因为撕裂边缘、接缝和纯色区域能立刻反映模型是在虚构细节还是保留原貌。对于已经锐利的高分辨率照片，精确放大工具能保留更多原始信息。

## 开始使用

1. 将 ComfyUI 更新到 0.44.0 或更高版本
2. 前往模板库，搜索 `Image Upscale: Topaz Wonder 4`


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