> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-462120c.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)

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

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

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](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 图像编辑工作流" />

<CardGroup cols={2}>
  <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">
    打开 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>
</CardGroup>

### 工作原理

该工作流接收两个输入图像：

* **主体图像**：你的角色或主要内容（含背景）
* **参考环境**：你想应用的新场景、光照或风格

节点生成输出时，会将主体自然地合成到新环境中，并带有合适的光照、阴影和透视效果。

### 运行步骤

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 视频编辑工作流" />

<CardGroup cols={2}>
  <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">
    打开 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>
</CardGroup>

### 工作原理

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

### 运行步骤

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

### 输出

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