> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.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 포함)로 저장할 수 있으며 워크플로우 메타데이터를 저장된 파일에 포함할 수 있습니다.
## 입력
### 공통 입력
| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 |
| ----------------- | ---------------------------------------------------------------------------------------------------------- | -------------- | -- | ---------------------------------- |
| `images` | 저장할 이미지입니다. | IMAGE | 예 | - |
| `filename_prefix` | 저장할 파일의 접두사입니다. `%date:yyyy-MM-dd%` 또는 `%Empty Latent Image.width%` 같은 형식 토큰을 포함할 수 있습니다. (기본값: "ComfyUI") | STRING | 예 | - |
| `format` | 이미지를 저장할 파일 형식입니다. 형식을 선택하면 해당 형식에 대한 추가 옵션이 표시됩니다. | 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 파일의 비트 심도입니다. (기본값: "32-bit float") | COMBO | 예 (조건부) | `"32-bit float"` |
| `input_color_space` | 입력 텐서의 색 공간입니다. EXR은 항상 일치하는 색역(gamut)에서 장면 선형(scene-linear)으로 기록됩니다.
`"sRGB"` — 입력이 sRGB로 인코딩된 Rec.709이며 역 sRGB EOTF가 적용됩니다.
`"HDR"` — 입력이 HLG로 인코딩된 Rec.2020(BT.2100)이며 장면 선형 광을 얻기 위해 역 HLG OETF가 적용됩니다.
`"linear"` — 입력이 이미 장면 선형(Rec.709 원색)이며 변경 없이 기록됩니다. 렌더러/합성 프로그램 출력에 사용하십시오. (기본값: "sRGB") | COMBO | 예 (조건부) | `"sRGB"`
`"HDR"`
`"linear"` |
### AVIF 입력
이 옵션은 `format`이 `"avif"`로 설정된 경우 표시됩니다.
| 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------- | ----------------------------------------------------- |
| `bit_depth` | 저장되는 AVIF 파일의 비트 심도입니다. auto는 sRGB에 8비트 YUV420을, HDR에 10비트 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 형식에서는 "32-bit float" 비트 심도만 사용할 수 있으며 색 공간은 "sRGB", "HDR" 또는 "linear"입니다.
* AVIF 형식에서는 `save_mode`가 `"animated"`로 설정된 경우에만 `fps`와 `loop_count`를 사용할 수 있습니다.
* PNG 및 EXR 이미지는 1(회색조), 3(RGB) 또는 4(RGBA) 채널이어야 합니다. 다른 채널 수는 지원되지 않으며 오류가 발생합니다.
* AVIF는 1채널 회색조 및 3채널 RGB 이미지만 지원합니다. RGBA(알파) 이미지는 지원되지 않으며 오류가 발생합니다.
## 출력
| 출력 이름 | 설명 | 데이터 유형 |
| -------- | ---------------------------------------------------------------------------------------------------- | ------ |
| `images` | 입력 이미지를 변경 없이 그대로 전달합니다. 노드의 UI 출력에는 저장된 이미지 결과 목록이 제공되며, 각 결과에는 파일 이름, 하위 폴더 및 유형("output")이 포함됩니다. | IMAGE |
> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SaveImageAdvanced/ko.md)
***
**Source fingerprint (SHA-256):** `d3df3caca99d58d973d0bc2ff7c22c4626185d390ec2acf870d4014331c4c335`