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

# ComfyUI SCAIL-2 キャラクター置換ワークフローチュートリアル

> SCAIL-2 を使用して、参照キャラクター画像を駆動ビデオの動きで駆動し、キャラクターアニメーションやビデオ内キャラクター置換を実現します。

**SCAIL-2** は、Wan2.1 上に構築されたエンドツーエンドのキャラクターアニメーションモデルです。駆動ビデオの動きを参照キャラクター画像に転送することで、キャラクターアニメーション（キャラクターに動きを実行させる）とビデオ内キャラクター置換（追跡された人物を参照キャラクターに置き換える）を可能にします。

**主な機能**：

* **エンドツーエンドのキャラクターアニメーション**：駆動ビデオの動きで静止キャラクター画像を駆動
* **2つのモード**：アニメーションモード（キャラクターが動きを実行）と置換モード（追跡人物を参照キャラクターに置き換え）
* **長尺ビデオ対応**：チャンクベースの重複フレーム拡張生成
* **組み込み ComfyUI ノード**：ネイティブの `WanSCAILToVideo`、`SCAIL2ColoredMask`、`SAM3` トラッキングを使用。標準モデルダウンロード以外にカスタムノードは不要

**関連リンク**：

* [Hugging Face: SCAIL-2](https://huggingface.co/zai-org/SCAIL-2)
* [SCAIL-2 拡散モデル](https://huggingface.co/Comfy-Org/SCAIL-2)

## SCAIL-2 キャラクター置換ワークフロー

<CardGroup cols={2}>
  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=video_wan21_scail2_character_replacement&utm_source=docs&utm_medium=referral&utm_campaign=scail2">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan21_scail2_character_replacement.json">
    JSON をダウンロードするか、テンプレートライブラリで "SCAIL-2" を検索
  </Card>
</CardGroup>

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

## ワークフローの仕組み

このワークフローは、2つのサブグラフノード：**Base** サブグラフ（最初のセグメント）と **Extend** サブグラフ（以降のセグメント）: を使用して、ショートビデオとロングビデオの両方のキャラクターアニメーションをサポートします。

1. 駆動ビデオ（`pose_video`）と参照キャラクター画像を**読み込み**
2. **Base サブグラフ** が最初のセグメント（デフォルト 81 フレーム）を処理
3. **Extend サブグラフ** が 2 番目以降のセグメントを処理し、前のセグメントの `previous_frames` を連鎖
4. 結果をプレビューして保存

<Card title="サブグラフについて" icon="book-open" href="/ja/interface/features/subgraph">
  このワークフローはモジュール処理に Subgraph ノードを使用します。ワークフローのカスタマイズと拡張については、サブグラフのドキュメントをご覧ください。
</Card>

### 長尺ビデオ

長いビデオの場合は、セグメント数を計算します：`ceil(total_frames / 76)`。最初のセグメント以外はすべて Extend サブグラフを使用します。さらにセグメントを追加するには Extend ノードを複製し、`previous_frames` 出力を連鎖させ、`segment_index` を増やします。

> **注意：** `WanSCAILToVideo` はすべてのセグメントを自動でキューできません：各セグメントは手動で実行してください。

## 2つのモード

| モード            | `replace_mode` | 駆動ビデオマスク背景 | 説明                          |
| -------------- | :------------: | :--------: | --------------------------- |
| **置換モード**      |  `true`（デフォルト） |      白     | 駆動ビデオで追跡された人物を参照キャラクターに置き換え |
| **アニメーションモード** |     `false`    |      黒     | 参照キャラクターが駆動ビデオの動きを実行        |

両方のサブグラフノードで `replace_mode` パラメータを設定します。

## 入力とパラメータ

### 共通パラメータ（Base と Extend）

| パラメータ                                       | 説明                                                     |
| ------------------------------------------- | ------------------------------------------------------ |
| `pose_video`                                | 動きを転送する駆動ビデオ                                           |
| `reference_image`                           | アニメーション化または挿入するキャラクター画像                                |
| `prompt`                                    | 出力ビデオの説明                                               |
| `replace_mode`                              | `true` = 置換モード、`false` = アニメーションモード                    |
| `segment_index`                             | `1` = 最初のチャンク、`2+` = 継続。ポーズオフセット = `76 × (インデックス − 1)` |
| `width` / `height`                          | 出力解像度（例: `896×512`）。16 で割り切れる必要あり                      |
| `frame_count`                               | セグメントあたりのフレーム数（デフォルト: 81）                              |
| `previous_frame_count`                      | セグメント間の重複フレーム数（デフォルト: 5）                               |
| `pose_strength` / `pose_start` / `pose_end` | ポーズ条件付けの強度とタイミング                                       |

### SAM3 トラッキング（2つの入力）

`sam3_video_object` と `sam3_image_object` 入力は、SAM3 マスクトラッキングを制御します：**SCAIL-2 の出力プロンプトではありません**。これらはカラーマスクでどのオブジェクトを追跡するかを決定します。

| 入力                  | ターゲット | 出力                     |
| ------------------- | ----- | ---------------------- |
| `sam3_video_object` | 駆動ビデオ | `pose_video_mask`      |
| `sam3_image_object` | 参照画像  | `reference_image_mask` |

* オープンボキャブラリテキストを使用（デフォルト: `human`）
* ビデオと参照で対象が同じ場合は同じ用語を使用
* ビデオと参照で異なるフォーカスが必要な場合（例：混雑したシーン）は異なる用語を使用

## モデルのインストール

まず ComfyUI を最新バージョンに更新して、組み込みの WanSCAILToVideo および SCAIL2ColoredMask ノードを入手してください。

### 必要なモデル

**diffusion\_models**

* [wan2.1\_14B\_SCAIL\_2\_fp16.safetensors](https://huggingface.co/Comfy-Org/SCAIL-2/resolve/main/diffusion_models/wan2.1_14B_SCAIL_2_fp16.safetensors)

**text\_encoders**（いずれか）

* [umt5\_xxl\_fp8\_e4m3fn\_scaled.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors)

**clip\_vision**

* [clip\_vision\_h.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/clip_vision/clip_vision_h.safetensors)

**vae**

* [Wan2\_1\_VAE\_bf16.safetensors](https://huggingface.co/Kijai/WanVideo_comfy/resolve/main/Wan2_1_VAE_bf16.safetensors)

**loras**

* [lightx2v\_I2V\_14B\_480p\_cfg\_step\_distill\_rank64\_bf16.safetensors](https://huggingface.co/Kijai/WanVideo_comfy/resolve/main/Lightx2v/lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors)
* [wan2.1\_SCAIL\_2\_DPO\_lora\_bf16.safetensors](https://huggingface.co/Comfy-Org/SCAIL-2/resolve/main/loras/wan2.1_SCAIL_2_DPO_lora_bf16.safetensors)

**checkpoints**

* [sam3.1\_multiplex\_fp16.safetensors](https://huggingface.co/Comfy-Org/sam3.1/resolve/main/checkpoints/sam3.1_multiplex_fp16.safetensors)

### ファイル保存場所

```
ComfyUI/
├── models/
│   ├── diffusion_models/
│   │   └── wan2.1_14B_SCAIL_2_fp16.safetensors
│   ├── text_encoders/
│   │   └── umt5_xxl_fp8_e4m3fn_scaled.safetensors
│   ├── clip_vision/
│   │   └── clip_vision_h.safetensors
│   ├── vae/
│   │   └── Wan2_1_VAE_bf16.safetensors
│   ├── loras/
│   │   ├── lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors
│   │   └── wan2.1_SCAIL_2_DPO_lora_bf16.safetensors
│   └── checkpoints/
│       └── sam3.1_multiplex_fp16.safetensors
```