> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-d5155ac.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](/ja/built-in-nodes/BeebleSwitchXImageEdit) Partner Nodes を使用すると、元の被写体を保持しながら、既存の画像や動画の環境、照明、スタイルを変換できます。被写体画像と参照環境をアップロードするだけで、SwitchX が被写体を新しいシーンにリアルな照明と影で合成します。

このガイドでは、Image Edit と Video Edit の 2 つのワークフローを紹介します。

<Tip>
  APIノードを使用するには、正しくログインしていることと、許可されたネットワーク環境で使用していることを確認する必要があります。APIノードの使用に必要な具体的な要件については、ドキュメントの「[APIノードの概要](/ja/tutorials/partner-nodes/overview)」セクションをご参照ください。
</Tip>

<Tip>
  <Tabs>
    <Tab title="ローカルユーザー">
      ComfyUI が最新版に更新されていることを確認してください。

      * [ComfyUI のダウンロード](https://www.comfy.org/download)
      * [更新手順](/ja/installation/update_comfyui)

      このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。
      テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。

      ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：

      1. 最新の ComfyUI（Nightly 版）を使用していない
      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>

### 仕組み

このワークフローは 2 つの入力画像を使用します：

* **被写体画像**：キャラクターやメインの被写体（背景込み）
* **参照環境**：適用したい新しいシーン、照明、スタイル

ノードは被写体を新しい環境に適切な照明、影、遠近感で自然に合成した出力を生成します。

### 実行手順

1. **被写体画像をアップロード**：最初の **LoadImage** ノードで被写体画像（例：ヘッドホンを着用した人物）を読み込みます
2. **参照画像をアップロード**：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`） | 編集領域を合成するための別のアルファマット動画  |