SaveImageAdvanced - ComfyUI Built-in Node Documentation

Save Image (Advanced) 节点将输入图像保存到你的 ComfyUI 输出目录，并提供对文件格式、位深度和色彩空间的高级控制。它支持保存为 PNG、EXR 或 AVIF 文件（包括动画 AVIF），并可将工作流元数据嵌入保存的文件中。

输入

参数	描述	数据类型	必需	范围
`图像`	要保存的图像。	IMAGE	是	-
`文件名前缀`	要保存文件的文件名前缀。可以包含格式化标记，例如 `%date:yyyy-MM-dd%` 或 `%Empty Latent Image.width%`。（默认值：“ComfyUI”）	STRING	是	-
`格式`	保存图像的文件格式。选择格式后会显示该格式的附加选项。	DYNAMIC_COMBO	是	`"png"` `"exr"` `"avif"`

当 format 设置为 "png" 时，会出现这些选项。

参数	描述	数据类型	必需	范围
`bit_depth`	保存的 PNG 文件的位深度。（默认值：“8-bit”）	COMBO	是（条件性）	`"8-bit"` `"16-bit"`
`input_color_space`	输入张量的色彩空间。PNG 格式仅支持 sRGB。（默认值：“sRGB”）	COMBO	是（条件性）	`"sRGB"`

当 format 设置为 "exr" 时，会出现这些选项。

参数	描述	数据类型	必需	范围
`bit_depth`	保存的 EXR 文件的位深度。（默认值：“32-bit float”）	COMBO	是（条件性）	`"32-bit float"`
`input_color_space`	输入张量的色彩空间。EXR 始终以匹配色域中的场景线性格式写入。 `"sRGB"` — 输入是 sRGB 编码的 Rec.709；应用逆 sRGB EOTF。 `"HDR"` — 输入是 HLG 编码的 Rec.2020（BT.2100）；应用逆 HLG OETF 以获得场景线性光。 `"linear"` — 输入已经是场景线性（Rec.709 原色）；原样写入。用于渲染器/合成器输出。（默认值：“sRGB”）	COMBO	是（条件性）	`"sRGB"` `"HDR"` `"linear"`

当 format 设置为 "avif" 时，会出现这些选项。

参数	描述	数据类型	必需	范围
`bit_depth`	保存的 AVIF 文件的位深度。自动模式为 sRGB 使用 8-bit YUV420，为 HDR 使用 10-bit YUV420。（默认值：“auto”）	COMBO	是（条件性）	`"auto"` `"8-bit YUV420"` `"10-bit YUV420"`
`input_color_space`	输入图像的色彩空间。HDR 选择 BT.2020/HLG，HDR PQ 选择 BT.2020/PQ。（默认值：“sRGB”）	COMBO	是（条件性）	`"sRGB"` `"HDR"` `"HDR PQ"`
`crf`	值越低，质量越高，文件越大。（默认值：18）	INT	是（条件性）	1 到 63
`save_mode`	AVIF 文件的保存模式。`"still images"` 将批次中的每个图像保存为单独的静态文件；`"animated"` 将整个批次保存为单个动画 AVIF 文件，并显示 `fps` 和 `loop_count`。（默认值：“still images”）	DYNAMIC_COMBO	是（条件性）	`"still images"` `"animated"`

当 save_mode 设置为 "animated" 时，会出现这些选项。

参数	描述	数据类型	必需	范围
`fps`	动画的帧率。（默认值：6.0）	FLOAT	是（条件性）	0.01 到 1000.0
`loop_count`	动画循环次数。0 表示无限循环。（默认值：0）	INT	是（条件性）	0 到 1000

参数依赖说明：

特定格式的参数（bit_depth、input_color_space，对于 AVIF 还有 crf 和 save_mode）仅在选择了特定 format 时可用。
对于 PNG 格式，仅提供 “8-bit” 和 “16-bit” 位深度，以及仅 “sRGB” 色彩空间。
对于 EXR 格式，仅提供 “32-bit float” 位深度，以及 “sRGB”、“HDR” 或 “linear” 色彩空间。
对于 AVIF 格式，fps 和 loop_count 仅在 save_mode 设置为 "animated" 时可用。
PNG 和 EXR 图像必须具有 1（灰度）、3（RGB）或 4（RGBA）个通道；不支持其他通道数，并会引发错误。
AVIF 仅支持 1 通道灰度和 3 通道 RGB 图像；不支持 RGBA（Alpha）图像，并会引发错误。

输出名称	描述	数据类型
`images`	输入图像，原样传递。节点的 UI 输出提供已保存图像结果的列表，每个结果包含文件名、子文件夹和类型（“output”）。对于包含多个图像的动画 AVIF，UI 输出还包含 `animated` 标志。	IMAGE

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): d3df3caca99d58d973d0bc2ff7c22c4626185d390ec2acf870d4014331c4c335