> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Beeble SwitchX Partner Nodes ComfyUI 官方示例

> 本指南介绍如何在 ComfyUI 中使用 Beeble SwitchX Partner Nodes 进行 AI 图像和视频重打光与环境替换

[Beeble SwitchX](/zh/built-in-nodes/BeebleSwitchXImageEdit) Partner Nodes 可让你在保留原始主体的同时，改变现有图像和视频的环境、光照和风格。上传角色或主体图像以及参考环境，SwitchX 会将你的主体合成到新场景中，并实现逼真的光照和阴影效果。

在本指南中，我们将展示 Image Edit 和 Video Edit 两个工作流。

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="便携版或手动安装用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在 ComfyUI 的[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新开发版（nightly）。
      2. 你用的是稳定版或桌面版（没有包含最新的更新）。
      3. 启动时有些节点导入失败。
    </Tab>

    <Tab title="桌面版或云端用户">
      * 桌面版是基于 ComfyUI 稳定版本构建的，它会在有新的桌面稳定版本发布时自动更新。
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新，我们会同步更新 Cloud。

      所以，如果你发现本教程中有任何核心节点缺失，那是因为对应的节点支持还在开发中没有发布正式的稳定版，请等待下一个稳定版本发布。
    </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: Image Edit"
</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: Video Edit"
</Card>

### 工作原理

该工作流接收源视频和参考图像，然后将参考光照和环境应用到视频中蒙版标记的主体区域。未蒙版区域保留原始像素和运动。工作流还会生成 alpha 通道蒙版，方便后期合成。

### 运行步骤

1. **上传源视频** — 使用 **LoadVideo** 节点加载输入视频
2. **上传参考图像** — 使用 **LoadImage** 节点加载目标环境/风格
3. **设置视频范围** — **Video Slice** 节点控制要处理的帧范围（起始、结束）
4. **输入提示词** — 在 **BeebleSwitchXVideoEdit** 中描述期望的环境和光照
5. **设置分辨率** — 选择输出分辨率
6. **调整种子** — 更改种子获取不同结果
7. **点击执行** — 按 `Ctrl+Enter`
8. **查看结果** — 编辑后的视频被保存，同时生成单独的 alpha 通道蒙版视频供合成使用

### 输出

| 输出                          | 说明                   |
| --------------------------- | -------------------- |
| **编辑后的视频**（`SaveVideo`）     | 蒙版区域应用了新环境和光照的最终视频   |
| **Alpha 通道蒙版**（`SaveVideo`） | 用于合成编辑区域的单独 alpha 视频 |