文档 /
节点说明 /
保存图像(高级)
保存图像(高级)
Save Image (Advanced) 节点将输入图像保存到你的 ComfyUI 输出目录,并提供对文件格式、位深度和色彩空间的高级控制。
节点说明
SaveImageAdvanced 更新于 2026-11-12
保存图像(高级) - ComfyUI Built-in Node Documentation
Save Image (Advanced) 节点将输入图像保存到你的 ComfyUI 输出目录,并提供对文件格式、位深度和色彩空间的高级控制。
Save Image (Advanced) 节点将输入图像保存到你的 ComfyUI 输出目录,并提供对文件格式、位深度和色彩空间的高级控制。它支持保存为 PNG、EXR 或 AVIF 文件(包括动画 AVIF),并可将工作流元数据嵌入保存的文件中。
输入
通用输入
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
图像 | 要保存的图像。 | IMAGE | 是 | - |
文件名前缀 | 要保存文件的文件名前缀。可以包含格式化标记,例如 %date:yyyy-MM-dd% 或 %Empty Latent Image.width%。(默认值:"ComfyUI") | STRING | 是 | - |
格式 | 保存图像的文件格式。选择格式后会显示该格式的附加选项。 | DYNAMIC\_COMBO | 是 | "png" "exr" "avif" |
PNG 输入
当 format 设置为 "png" 时,会出现这些选项。
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
bit_depth | 保存的 PNG 文件的位深度。(默认值:"8-bit") | COMBO | 是(条件性) | "8-bit" "16-bit" |
input_color_space | 输入张量的色彩空间。PNG 格式仅支持 sRGB。(默认值:"sRGB") | COMBO | 是(条件性) | "sRGB" |
EXR 输入
当 format 设置为 "exr" 时,会出现这些选项。
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
bit_depth | 保存的 EXR 文件的位深度。(默认值:"16-bit float") | COMBO | 是(条件性) | "16-bit float" "32-bit float" |
input_color_space | 输入张量的色彩空间。EXR 始终以匹配色域中的场景线性格式写入。 "sRGB" — 输入是 sRGB 编码的 Rec.709;应用逆 sRGB EOTF。 "HDR" — 输入是 HLG 编码的 Rec.2020(BT.2100);应用逆 HLG OETF 以获得场景线性光。 "linear" — 输入已经是场景线性(Rec.709 原色);原样写入。用于渲染器/合成器输出。 "linear ACEScg" — 输入已经是 ACEScg 场景线性(AP1 / D60);原样写入,并使用 ACEScg 色度。(默认值:"sRGB") | COMBO | 是(条件性) | "sRGB" "HDR" "linear" "linear ACEScg" |
AVIF 输入
当 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" |
AVIF 动画选项
当 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 格式,提供 "16-bit float" 和 "32-bit float" 两种位深度,以及 "sRGB"、"HDR"、"linear" 或 "linear ACEScg" 色彩空间。"16-bit float" 为默认值,生成的文件更小。
- 对于 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): ebbb78aedbfeb48239d900eee2170e04899e2b5b841a720209258f68dd6241f8