TopazImageEnhanceV2 - ComfyUI Built-in Node Documentation

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

​输入

​通用输入

​Reimagine 输入

​Bloom 2 输入

​Wonder 3.5 输入

​输出

输入

通用输入

Reimagine 输入

Bloom 2 输入

Wonder 3.5 输入

输出