> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# TopazImageEnhanceV2 - ComfyUI Built-in Node Documentation
> Topaz Image Enhance는 Topaz 모델을 사용하여 단일 입력 이미지에 업계 표준 업스케일링 및 이미지 향상을 적용합니다. 이미지를 Topaz API로 전송하고, 선택한 모델로 처리한 뒤 향상된 결과를 반환합니다.
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` | 0 값은 자동으로 계산함을 의미합니다(일반적으로 원본 크기가 되거나, `output_height`가 지정된 경우 해당 값에 비례하여 조정됩니다). Wonder 3.5는 1x\~6x의 업스케일 배율만 지원합니다. Bloom 2와 Wonder 3.5는 입력 종횡비를 유지하며 요청된 크기를 목표로 간주합니다. (기본값: 0) | INT | 아니요 | 0 \~ 32000 |
| `output_height` | 0 값은 원본과 동일한 높이로 출력하거나, `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` | 사용할 그레인 모델입니다. `grain`이 비활성화된 경우 무시됩니다. | COMBO | 예 | `"silver"`
`"gaussian"`
`"grey"` |
| `grain_strength` | 그레인 효과의 강도입니다. `grain`이 비활성화된 경우 무시됩니다. (기본값: 0.5) | FLOAT | 예 | 0.0 \~ 1.0 |
| `grain_size` | 그레인 입자의 크기입니다. `grain`이 비활성화된 경우 무시됩니다. (기본값: 1.0) | FLOAT | 예 | 1.0 \~ 5.0 |
| `grain_density` | 그레인 효과의 세기입니다. `grain`이 비활성화된 경우 무시됩니다. (기본값: 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` | 사용할 그레인 모델입니다. `grain`이 비활성화된 경우 무시됩니다. | COMBO | 예 | `"silver"`
`"gaussian"`
`"grey"` |
| `grain_strength` | 그레인 효과의 강도입니다. `grain`이 비활성화된 경우 무시됩니다. (기본값: 0.5) | FLOAT | 예 | 0.0 \~ 1.0 |
| `grain_size` | 그레인 입자의 크기입니다. `grain`이 비활성화된 경우 무시됩니다. (기본값: 1.0) | FLOAT | 예 | 1.0 \~ 5.0 |
| `grain_density` | 그레인 효과의 세기입니다. `grain`이 비활성화된 경우 무시됩니다. (기본값: 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에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TopazImageEnhanceV2/ko.md)
***
**Source fingerprint (SHA-256):** `19bb03ca7354f1b0d1e559b742b83939678fce6d5f490b1030717b846043e0e6`