> ## 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.
# TopazVideoEnhanceV2 - ComfyUI Built-in Node Documentation
> Topaz Video Enhance V2 노드는 강력한 업스케일링 및 복원 기술로 비디오에 새로운 생명을 불어넣습니다. 다양한 Topaz 업스케일러 모델을 사용하여 비디오의 해상도를 높이고, 프레임 보간을 통해 프레임 레이트를 조정하며, 창의적이거나 사실적인 향상 설정을 적용할 수 있습니다.
**Topaz Video Enhance V2** 노드는 강력한 업스케일링 및 복원 기술로 비디오에 새로운 생명을 불어넣습니다. 다양한 Topaz 업스케일러 모델을 사용하여 비디오의 해상도를 높이고, 프레임 보간을 통해 프레임 레이트를 조정하며, 창의적이거나 사실적인 향상 설정을 적용할 수 있습니다.
## 입력
### 공통 입력
| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 |
| ---------- | -------------------------------------------------------------------------------------------------- | -------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------- |
| `비디오` | 처리할 입력 비디오입니다. MP4 컨테이너 형식이어야 합니다. | VIDEO | 예 | - |
| `업스케일러 모델` | 비디오를 업스케일링하는 데 사용되는 AI 모델입니다. 사용 가능한 하위 매개변수는 선택한 모델에 따라 달라집니다. `"Disabled"`를 선택하면 업스케일링이 비활성화됩니다. | DYNAMIC\_COMBO | 예 | `"Astra 2"`
`"Starlight (Astra) Fast"`
`"Starlight (Astra) Creative"`
`"Starlight Precise 2.5"`
`"Disabled"` |
| `보간 모델` | 프레임 보간에 사용되는 AI 모델입니다. 사용 가능한 하위 매개변수는 선택한 모델에 따라 달라집니다. `"Disabled"`를 선택하면 보간이 비활성화됩니다. | DYNAMIC\_COMBO | 예 | `"Disabled"`
`"apo-8"` |
| `동적 압축 레벨` | 비디오 압축에 사용되는 CQP 레벨입니다 (기본값: `"Low"`). | COMBO | 아니요 | `"Low"`
`"Mid"`
`"High"` |
다음 섹션에서는 `upscaler_model` 및 `interpolation_model` 선택기의 각 옵션에 대해 표시되는 하위 매개변수를 설명합니다. `"Disabled"` 옵션은 추가 매개변수를 표시하지 않습니다.
### Astra 2 입력
| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 |
| ------------------------------------ | ------------------------------------------------------------------------------------ | ------ | ------------------ | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 업스케일의 대상 출력 해상도입니다. | COMBO | 예 ("Astra 2" 선택 시) | `"FullHD (1080p)"`
`"4K (2160p)"` |
| `upscaler_model.creativity` | 업스케일의 창의적 강도입니다 (기본값: 0.5). | FLOAT | 아니요 | 0.0 \~ 1.0 (단계: 0.1) |
| `upscaler_model.prompt` | 선택적인 설명형(지시형이 아닌) 장면 프롬프트입니다. 설정 시 입력이 450프레임(\~30fps에서 약 15초)으로 제한됩니다 (기본값: 비어 있음). | STRING | 아니요 | - |
| `upscaler_model.sharp` | 사전 강화 선명도: 0.0=가우시안 블러, 0.5=그대로 통과(기본값), 1.0=USM 선명화. | FLOAT | 아니요 | 0.0 \~ 1.0 (단계: 0.01) |
| `upscaler_model.realism` | 출력을 사진적 사실감 쪽으로 유도합니다. 모델 기본값을 사용하려면 0으로 두십시오 (기본값: 0.0). | FLOAT | 아니요 | 0.0 \~ 1.0 (단계: 0.01) |
### Starlight (Astra) Fast 입력
| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 |
| ------------------------------------ | ------------------- | ------ | ------------- | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 업스케일의 대상 출력 해상도입니다. | COMBO | 예 (이 모델 선택 시) | `"FullHD (1080p)"`
`"4K (2160p)"` |
### Starlight (Astra) Creative 입력
| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 |
| ------------------------------------ | ------------------------------- | ------ | ------------- | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 업스케일의 대상 출력 해상도입니다. | COMBO | 예 (이 모델 선택 시) | `"FullHD (1080p)"`
`"4K (2160p)"` |
| `upscaler_model.creativity` | 업스케일의 창의적 강도입니다 (기본값: `"low"`). | COMBO | 아니요 | `"low"`
`"middle"`
`"high"` |
### Starlight Precise 2.5 입력
| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 |
| ------------------------------------ | ------------------- | ------ | ------------- | -------------------------------------- |
| `upscaler_model.upscaler_resolution` | 업스케일의 대상 출력 해상도입니다. | COMBO | 예 (이 모델 선택 시) | `"FullHD (1080p)"`
`"4K (2160p)"` |
### apo-8 입력
| 매개변수 | 설명 | 데이터 유형 | 필수 여부 | 범위 |
| ------------------------------------------------------- | -------------------------------------------------------------------------------- | ------- | ---------------- | ------------------------ |
| `interpolation_model.interpolation_frame_rate` | 출력 프레임 레이트입니다 (기본값: 60). | INT | 예 ("apo-8" 선택 시) | 15 \~ 240 |
| `interpolation_model.interpolation_slowmo` | 입력 비디오에 적용되는 슬로우모션 배수입니다. 예를 들어, 2로 설정하면 출력이 두 배로 느려지고 재생 시간이 두 배가 됩니다 (기본값: 1). | INT | 아니요 | 1 \~ 16 |
| `interpolation_model.interpolation_duplicate` | 입력에서 중복 프레임을 분석하여 제거합니다 (기본값: False). | BOOLEAN | 아니요 | True
False |
| `interpolation_model.interpolation_duplicate_threshold` | 중복 프레임 감지 민감도입니다 (기본값: 0.01). | FLOAT | 아니요 | 0.001 \~ 0.1 (단계: 0.001) |
**중요 제약 사항:**
* `upscaler_model` 또는 `interpolation_model` 중 하나 이상이 활성화되어야 합니다. 둘 다 `"Disabled"`로 설정되면 처리할 내용이 없으므로 노드가 오류를 발생시킵니다.
* 입력 `video`는 MP4 컨테이너 형식이어야 합니다.
* `"Astra 2"` 모델은 입력 프레임이 9000개로 제한됩니다. `prompt`가 설정된 경우 제한은 입력 프레임 450개(\~30fps에서 약 15초)입니다. 비디오가 해당 제한을 초과하면 노드가 오류를 발생시킵니다.
* `"Disabled"`가 아닌 업스케일러 모델을 선택할 때마다 `upscaler_model.upscaler_resolution`이 필요합니다. `"FullHD (1080p)"`는 1080p 결과를 대상으로 하고 `"4K (2160p)"`는 2160p 결과를 대상으로 합니다. 정확한 출력 너비와 높이는 입력 가로세로 비율에서 계산되며, 각각 최대 긴 변 1920 또는 3840픽셀로 제한되고 짝수로 반올림됩니다.
* `interpolation_model`이 `"apo-8"`일 때마다 `interpolation_model.interpolation_frame_rate`가 필요합니다.
* 현재 매우 큰 파일은 지원되지 않습니다. 업로드는 단일 파트로 제한되며, 그렇지 않으면 노드가 오류를 발생시킵니다.
* 여러 매개변수(`sharp`, `realism`, `interpolation_slowmo`, `interpolation_duplicate`, `interpolation_duplicate_threshold`)는 UI에서 고급으로 표시되며 기본적으로 숨겨져 있을 수 있습니다.
## 출력
| 출력 이름 | 설명 | 데이터 유형 |
| ------- | ---------------------------------------- | ------ |
| `video` | 선택한 업스케일링 및/또는 보간 필터를 적용한 후의 향상된 비디오입니다. | VIDEO |
> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TopazVideoEnhanceV2/ko.md)
***
**Source fingerprint (SHA-256):** `14627dc772a6a46a645517bd34b545e0986a84561e24bdfe810b67f791ee47e3`