> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# BeebleSwitchXVideoEdit - ComfyUI Built-in Node Documentation

> Complete documentation for the BeebleSwitchXVideoEdit node in ComfyUI. Learn its inputs, outputs, parameters and usage.

# Beeble SwitchX 비디오 편집

Beeble SwitchX로 비디오를 편집합니다. 이 노드는 원본 피사체의 픽셀과 움직임을 유지하면서 장면의 모든 요소(배경, 조명, 의상)를 전환할 수 있습니다. 새로운 모습을 설명하는 참조 이미지 및/또는 텍스트 프롬프트를 제공하세요.

## 입력

| 매개변수              | 설명                                                                                                                                              | 데이터 타입 | 필수 여부 | 범위                                       |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----- | ---------------------------------------- |
| `video`           | 편집할 입력 비디오입니다. 최대 240프레임, 프레임당 최대 약 277만 화소입니다.                                                                                                 | VIDEO  | 예     | 해당 없음                                    |
| `prompt`          | 장면에 원하는 새로운 모습에 대한 텍스트 설명입니다.                                                                                                                   | STRING | 예     | 해당 없음                                    |
| `alpha_mode`      | 알파 매트 모드입니다. "fill" 모드는 별도의 매트 없이 전체 프레임을 채웁니다. "select" 모드는 단일 키프레임 이미지를 사용하여 편집할 영역을 정의합니다. "custom" 모드는 전체 알파 비디오를 사용하여 프레임별로 편집할 영역을 정의합니다. | COMBO  | 예     | `"fill"`<br />`"select"`<br />`"custom"` |
| `max_resolution`  | 출력 비디오의 최대 해상도입니다(기본값: "1080p").                                                                                                                | COMBO  | 예     | `"720p"`<br />`"1080p"`                  |
| `seed`            | 재현성을 위한 시드 값입니다. 동일한 입력에 동일한 시드를 사용하면 동일한 결과가 생성됩니다.                                                                                            | INT    | 예     | 0 \~ 2147483647                          |
| `reference_image` | 장면에 원하는 새로운 모습을 설명하는 선택적 참조 이미지입니다.                                                                                                             | IMAGE  | 아니요   | 해당 없음                                    |

### 알파 모드 상세 설명

`alpha_mode` 매개변수는 비디오의 어떤 부분이 편집될지를 제어합니다:

* **fill**: 전체 비디오 프레임이 편집됩니다. 별도의 알파 매트가 생성되지 않습니다.
* **select**: 편집할 영역을 정의하는 단일 키프레임 이미지를 제공합니다. 노드는 이를 사용하여 비디오의 어떤 부분을 변경할지 결정합니다.
* **custom**: 프레임별로 편집할 영역을 정의하는 전체 알파 비디오를 제공합니다. 이를 통해 각 프레임의 어떤 부분을 편집할지 정밀하게 제어할 수 있습니다.

`select` 모드를 사용할 때는 `alpha_keyframe` 이미지를 반드시 제공해야 합니다. `custom` 모드를 사용할 때는 `alpha_mask` 비디오를 반드시 제공해야 합니다.

## 출력

| 출력 이름   | 설명                                                        | 데이터 타입 |
| ------- | --------------------------------------------------------- | ------ |
| `alpha` | 장면 변경이 적용된 편집된 비디오입니다.                                    | VIDEO  |
| `alpha` | Beeble에서 사용한 알파 매트입니다. "fill" 모드에서는 별도의 매트가 없으므로 비어 있습니다. | VIDEO  |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BeebleSwitchXVideoEdit/ko.md)

***

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