> ## 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.

# Beeble SwitchX 파트너 노드 ComfyUI 공식 예제

> 이 가이드에서는 ComfyUI에서 Beeble SwitchX 파트너 노드를 사용해 AI 기반 이미지 및 비디오 재조명과 환경 편집을 수행하는 방법을 설명합니다.

[Beeble SwitchX](/ko/built-in-nodes/BeebleSwitchXImageEdit) 파트너 노드를 사용하면 기존 이미지와 비디오의 환경, 조명, 스타일을 변형하면서도 원래의 피사체는 그대로 유지할 수 있습니다. 캐릭터나 피사체 이미지와 참조 환경을 업로드하면 SwitchX가 실제와 같은 조명과 그림자를 적용해 새로운 장면에 피사체를 합성합니다.

이 가이드에서는 이미지 편집과 비디오 편집 워크플로우를 사용하는 방법을 보여드립니다.

<Tip>
  파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](/ko/tutorials/partner-nodes/overview) 섹션을 참조해 주세요.
</Tip>

<Tip>
  <Tabs>
    <Tab title="휴대용 또는 자체 배포 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다. (데스크톱 버전의 업데이트는 다소 지연될 수 있습니다)

      워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="데스크톱 또는 클라우드 사용자">
      * 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

## Beeble SwitchX: 이미지 편집

배경 환경을 교체하고 참조 이미지를 통해 피사체의 조명을 다시 설정하세요.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_beeble_switchx_image_edit-1.webp" alt="Beeble SwitchX 이미지 편집 워크플로우" />

<Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_beeble_switchx_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=beeble_switchx_img">
  Comfy Cloud에서 열기
</Card>

<Card title="워크플로우 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_beeble_switchx_image_edit.json">
  JSON 다운로드 또는 템플릿 라이브러리에서 "Beeble SwitchX: 이미지 편집" 검색
</Card>

### 작동 방식

이 워크플로우는 두 개의 입력 이미지를 사용합니다:

* **피사체 이미지** — 배경이 포함된 캐릭터나 주요 피사체
* **참조 환경** — 적용하려는 새로운 장면, 조명 또는 스타일

노드는 피사체가 새 환경에 자연스럽게 합성되고 적절한 조명, 그림자, 원근감이 적용된 출력을 생성합니다.

### 실행 단계

1. **피사체 이미지 업로드** — 첫 번째 **LoadImage** 노드를 사용해 피사체 이미지를 로드하세요(예: 헤드폰을 착용한 사람)
2. **참조 이미지 업로드** — 두 번째 **LoadImage** 노드를 사용해 목표 환경이나 스타일을 로드하세요
3. **프롬프트 입력** — **BeebleSwitchXImageEdit** 노드에서 장면을 설명하세요
4. **해상도 설정** — 출력 해상도를 선택하세요
5. **시드 조정** — 다른 결과를 위해 시드 값을 변경하세요
6. **큐 클릭** — `Ctrl+Enter`를 눌러 생성하세요
7. **결과 확인** — 편집된 이미지는 **SaveImage**에 나타나며, 마스크 처리된 컷아웃은 별도로 저장됩니다

### 노드 매개변수

| 매개변수         | 설명                   |
| ------------ | -------------------- |
| `prompt`     | 장면과 환경에 대한 설명        |
| `resolution` | 출력 해상도 (예: 720p)     |
| `seed`       | 재현 가능한 결과를 위한 임의의 시드 |

## Beeble SwitchX: 비디오 편집

비디오에 환경 재조명을 적용하면서 원래의 모션과 마스크 해제된 영역은 그대로 유지하세요.

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_beeble_switchx_video_edit-1.webp" alt="Beeble SwitchX 비디오 편집 워크플로우" />

<Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_beeble_switchx_video_edit&utm_source=docs&utm_medium=referral&utm_campaign=beeble_switchx_vid">
  Comfy Cloud에서 열기
</Card>

<Card title="워크플로우 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_beeble_switchx_video_edit.json">
  JSON 다운로드 또는 템플릿 라이브러리에서 "Beeble SwitchX: 비디오 편집" 검색
</Card>

### 작동 방식

이 워크플로우는 소스 비디오와 참조 이미지를 받아들인 후, 참조 조명과 환경을 비디오의 마스크 처리된 피사체 영역에 적용합니다. 마스크 해제된 영역은 원래 픽셀과 모션을 그대로 유지합니다. 또한 워크플로우는 간편한 합성을 위해 알파 마스크를 생성합니다.

### 실행 단계

1. **소스 비디오 업로드** — **LoadVideo** 노드를 사용해 입력 비디오를 로드하세요
2. **참조 이미지 업로드** — **LoadImage** 노드를 사용해 목표 환경/스타일을 로드하세요
3. **비디오 범위 설정** — **Video Slice** 노드를 사용해 처리할 프레임을 지정하세요(시작, 끝, 포함 여부)
4. **프롬프트 입력** — **BeebleSwitchXVideoEdit** 노드에서 원하는 환경과 조명을 설명하세요
5. **해상도 설정** — 출력 해상도를 선택하세요
6. **시드 조정** — 다른 결과를 위해 시드 값을 변경하세요
7. **큐 클릭** — `Ctrl+Enter`를 누르세요
8. **결과 확인** — 편집된 비디오는 저장되며, 별도의 알파 마스크 비디오는 합성을 위해 생성됩니다

### 출력물

| 출력물                       | 설명                                |
| ------------------------- | --------------------------------- |
| **편집된 비디오** (`SaveVideo`) | 마스크 처리된 영역에 새로운 환경/조명이 적용된 최종 비디오 |
| **알파 마스크** (`SaveVideo`)  | 편집된 영역을 합성하기 위한 별도의 알파 비디오        |