# Topaz 이미지 향상

Topaz Image Enhance는 Topaz 모델을 사용하여 단일 입력 이미지에 업계 표준 업스케일링 및 이미지 향상을 적용합니다. 이미지를 Topaz API로 전송하고, 선택한 모델로 처리한 뒤 향상된 결과를 반환합니다. Reimagine, Bloom 2, Wonder 3.5, Wonder 4의 네 가지 모델 중에서 선택할 수 있습니다.

## 입력

### 공통 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
|-----------|-------------|-----------|----------|-------|
| `image` | 향상할 입력 이미지입니다. 하나의 입력 이미지만 지원됩니다. | IMAGE | 예 | 단일 이미지 |
| `model` | 사용할 Topaz 향상 모델입니다. 선택한 모델에 따라 표시되는 모델별 설정이 결정됩니다. | DYNAMIC_COMBO | 예 | `"Reimagine"`<br>`"Bloom 2"`<br>`"Wonder 3.5"`<br>`"Wonder 4"` |
| `output_width` | 0 값은 자동으로 계산함을 의미합니다(일반적으로 원본 크기가 되거나, `output_height`가 지정된 경우 해당 값에 비례하여 조정됩니다). Wonder 3.5와 Wonder 4는 1x~6x, Bloom 2는 1x~12x의 업스케일 배율을 지원합니다. Bloom 2, Wonder 3.5, Wonder 4는 항상 입력 종횡비를 유지합니다. 두 크기를 모두 설정했는데 비율이 다르면 더 큰 배율이 적용되어 출력이 요청한 크기보다 커지고 요금도 요청한 크기 기준보다 높아집니다. (기본값: 0) | INT | 아니요 | 0  ~  32000 |
| `output_height` | 0 값은 원본과 동일한 높이로 출력하거나, `output_width`가 지정된 경우 해당 값에 비례하여 조정함을 의미합니다. Wonder 3.5와 Wonder 4는 1x~6x, Bloom 2는 1x~12x의 업스케일 배율을 지원합니다. Bloom 2, Wonder 3.5, Wonder 4는 항상 입력 종횡비를 유지합니다. 두 크기를 모두 설정했는데 비율이 다르면 더 큰 배율이 적용되어 출력이 요청한 크기보다 커지고 요금도 요청한 크기 기준보다 높아집니다. (기본값: 0) | INT | 아니요 | 0  ~  32000 |

### Reimagine 입력

이 설정은 `model`이 `"Reimagine"`으로 설정된 경우 적용됩니다.

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
|-----------|-------------|-----------|----------|-------|
| `prompt` | 창의적 업스케일링 지침을 위한 선택적 텍스트 프롬프트입니다. (기본값: "") | STRING | 예 | 임의 텍스트 |
| `creativity` | 향상에 대한 창의성 수준입니다. (기본값: 3) | INT | 예 | 1  ~  9 |
| `subject_detection` | 피사체 감지 모드(고급)입니다. | COMBO | 예 | `"All"`<br>`"Foreground"`<br>`"Background"` |
| `face_enhancement` | 처리 중 얼굴이 있는 경우 얼굴을 향상합니다. (기본값: True) | BOOLEAN | 예 | true<br>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<br>false |
| `color_preservation` | 원본 색상을 유지합니다. (기본값: True) | BOOLEAN | 예 | true<br>false |
| `crop_to_fill` | 기본적으로 출력 종횡비가 다를 때 이미지에 레터박스가 적용됩니다. 활성화하면 출력 크기를 채우도록 이미지를 자릅니다. (기본값: False) | BOOLEAN | 예 | true<br>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<br>false |
| `grain` | 출력 이미지에 그레인을 추가합니다. (기본값: False) | BOOLEAN | 예 | true<br>false |
| `grain_model` | 사용할 그레인 모델입니다. `grain`이 비활성화된 경우 무시됩니다. | COMBO | 예 | `"silver"`<br>`"gaussian"`<br>`"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"`<br>`"medium"`<br>`"high"` |
| `grain` | 출력 이미지에 그레인을 추가합니다. (기본값: False) | BOOLEAN | 예 | true<br>false |
| `grain_model` | 사용할 그레인 모델입니다. `grain`이 비활성화된 경우 무시됩니다. | COMBO | 예 | `"silver"`<br>`"gaussian"`<br>`"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의 업스케일 배율만 지원합니다. Wonder 4는 공통 입력만 제공합니다. 출력은 179 메가픽셀, 한 변당 32000픽셀로 제한됩니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
|-------------|-------------|-----------|
| `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):** `dd109d31ea4ab7928058414c3a62ae3829f879354ebdce329b599aacb9804d1b`
