> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SaveImageAdvanced - 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"`<br />`"exr"`<br />`"avif"` |

### PNG 输入

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

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

### EXR 输入

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

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

### AVIF 输入

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

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `bit_depth` | 保存的 AVIF 文件的位深度。自动模式为 sRGB 使用 8-bit YUV420，为 HDR 使用 10-bit YUV420。（默认值："auto"） | COMBO | 是（条件性） | `"auto"`<br />`"8-bit YUV420"`<br />`"10-bit YUV420"` |
| `input_color_space` | 输入图像的色彩空间。HDR 选择 BT.2020/HLG，HDR PQ 选择 BT.2020/PQ。（默认值："sRGB"） | COMBO | 是（条件性） | `"sRGB"`<br />`"HDR"`<br />`"HDR PQ"` |
| `crf` | 值越低，质量越高，文件越大。（默认值：18） | INT | 是（条件性） | 1 到 63 |
| `save_mode` | AVIF 文件的保存模式。`"still images"` 将批次中的每个图像保存为单独的静态文件；`"animated"` 将整个批次保存为单个动画 AVIF 文件，并显示 `fps` 和 `loop_count`。（默认值："still images"） | DYNAMIC\_COMBO | 是（条件性） | `"still images"`<br />`"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" 色彩空间。"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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveImageAdvanced/zh.md)

***

**Source fingerprint (SHA-256):** `a0f7fccb3b25ffa814bf5d2a970c41fd4114368eb9a9998880b1108a272a41bb`


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