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" "Bloom 2" "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" "Foreground" "Background"
face_enhancement	在处理过程中增强人脸（如果存在）。 (默认: True)	BOOLEAN	是	true 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 false
color_preservation	保留原始颜色。 (默认: True)	BOOLEAN	是	true false
crop_to_fill	默认情况下，当输出宽高比不同时，图像会以信箱模式添加黑边。启用后将裁剪图像以填满输出尺寸。 (默认: False)	BOOLEAN	是	true 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 false
grain	为输出图像添加颗粒。 (默认: False)	BOOLEAN	是	true false
grain_model	要使用的颗粒模型。如果禁用颗粒，则忽略此项。	COMBO	是	"silver" "gaussian" "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" "medium" "high"
grain	为输出图像添加颗粒。 (默认: False)	BOOLEAN	是	true false
grain_model	要使用的颗粒模型。如果禁用颗粒，则忽略此项。	COMBO	是	"silver" "gaussian" "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 上编辑

---

Source fingerprint (SHA-256): 19bb03ca7354f1b0d1e559b742b83939678fce6d5f490b1030717b846043e0e6