> ## 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](/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="デスクトップ版またはクラウド版ユーザー">
      * デスクトップ版は ComfyUI の安定版（Stable Release）をベースとしており、新しいデスクトップ安定版がリリースされると自動的に更新されます。
      * [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 画像編集ワークフロー" />

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

### 仕組み

このワークフローは 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 動画編集ワークフロー" />

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

### 仕組み

このワークフローはソース動画と参照画像を受け取り、動画内のマスクされた被写体領域に参照照明と環境を適用します。マスクされていない領域は元のピクセルと動きを保持します。また、合成用のアルファマットも生成します。

### 実行手順

1. **ソース動画をアップロード** — **LoadVideo** ノードで入力動画を読み込み
2. **参照画像をアップロード** — **LoadImage** ノードでターゲット環境/スタイルを読み込み
3. **動画範囲を設定** — **Video Slice** ノードで処理するフレーム範囲を指定（開始、終了）
4. **プロンプトを入力** — **BeebleSwitchXVideoEdit** で希望の環境と照明を説明
5. **解像度を設定** — 出力解像度を選択
6. **シードを調整** — シードを変更して異なる結果を試す
7. **実行** — `Ctrl+Enter`
8. **結果を確認** — 編集済み動画が保存され、合成用のアルファマット動画も生成

### 出力

| 出力                       | 説明                       |
| ------------------------ | ------------------------ |
| **編集済み動画**（`SaveVideo`）  | マスク領域に新しい環境/照明が適用された最終動画 |
| **アルファマット**（`SaveVideo`） | 編集領域の合成用アルファチャンネル動画      |