> ## 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 Wan2.1 VACE 動画サンプル

> 本記事では、ComfyUI で Wan VACE 動画生成のサンプルを完了する方法を紹介します。

> [!WARNING]
>
> テンプレートの調整および CausVid LoRA に関する使用方法・説明の追加を行ったため、本ドキュメントは更新が必要です。更新作業には一定の準備期間が必要となるため、その間はテンプレート内の注記を参照してご使用ください。

## VACE について

VACE 14B は、アリババ Tongyi Wanxiang チームが公開したオープンソースの統合型動画編集モデルです。このモデルは、複数のタスクを統合した機能、高解像度処理のサポート、および柔軟なマルチモーダル入力機構を備えており、動画制作の効率性と品質を大幅に向上させます。

本モデルは [Apache-2.0](https://github.com/ali-vilab/VACE?tab=Apache-2.0-1-ov-file) ライセンスの下でオープンソース化されており、個人利用および商用利用が可能です。

以下に、その主な特徴および技術的ハイライトを総合的に解説します：

* マルチモーダル入力：テキスト、画像、動画、マスク、制御信号など、複数の入力形式をサポート
* 統合アーキテクチャ：単一のモデルで複数のタスクをサポートし、機能を自由に組み合わせ可能
* モーション転送：参照動画に基づいて連続的かつ自然な動作を生成
* 局所的置換：マスクを用いて動画内の特定領域を置換
* 動画拡張：動作の補完や背景の延長を実行
* 背景置換：被写体を保持したまま、環境の背景を変更

現在、VACE は 1.3B および 14B の 2 つのバージョンをリリースしています。1.3B バージョンと比較して、14B バージョンは 720P 解像度での出力をサポートし、画質の詳細と安定性が向上しています。

| モデル | 480P | 720P |
| - | - | - |
| [VACE-1.3B](https://huggingface.co/Wan-AI/Wan2.1-VACE-1.3B) | ✅ | ❌ |
| [VACE-14B](https://huggingface.co/Wan-AI/Wan2.1-VACE-14B) | ✅ | ✅ |

関連するモデル重みおよびコードリポジトリ：

> [card] [VACE-1.3B](https://huggingface.co/Wan-AI/Wan2.1-VACE-1.3B)
>
> Hugging Face 上の 1.3B モデル重み

> [card] [VACE-14B](https://huggingface.co/Wan-AI/Wan2.1-VACE-14B)
>
> Hugging Face 上の 14B モデル重み

> [card] [GitHub リポジトリ](https://github.com/ali-vilab/VACE)
>
> VACE ソースコードとドキュメント

> [card] [VACE プロジェクトページ](https://ali-vilab.github.io/VACE-Page/)
>
> 公式プロジェクトホームページ（作例付き）

> [!TIP]
>
> > [tab] ローカルユーザー
> >
> > ComfyUI が最新版に更新されていることを確認してください。
> >
> > * [ComfyUI のダウンロード](https://www.comfy.org/download)
> > * [更新手順](https://docs.comfy.org/ja/installation/update_comfyui.md)
> >
> > このガイドで紹介するワークフローは、[ワークフローテンプレート](https://docs.comfy.org/ja/interface/features/template.md)から入手できます。
> > テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。
> >
> > ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：
> >
> > 1. 最新の ComfyUI（Nightly 版）を使用していない
> > 2. 起動時に一部のノードのインポートに失敗している
>
> > [tab] クラウドユーザー
> >
> > * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
> >
> > したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。

## モデルのダウンロードおよびワークフローへの読み込み

本ドキュメントで紹介するすべてのワークフローは同一のワークフローテンプレートを使用しているため、まずモデルのダウンロードと読み込み手順の説明を完了し、その後、異なるノードを Bypass（無効化）することで、各種入力の有効／無効を切り替えて、異なるワークフローを実現できます。\
なお、具体的なサンプルワークフローの情報内には既にモデルのダウンロード情報が埋め込まれているため、サンプルワークフローをダウンロードする際に同時にモデルも取得できます。

### モデルのダウンロード

**Diffusion Models**

> [card] [wan2.1\_vace\_14B\_fp16.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/diffusion_models/wan2.1_vace_14B_fp16.safetensors)
>
> VACE 14B 拡散モデル（推奨、約32GB）。`ComfyUI/models/diffusion_models/` に配置してください。

> [card] [wan2.1\_vace\_1.3B\_fp16.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/diffusion_models/wan2.1_vace_1.3B_fp16.safetensors)
>
> VACE 1.3B 拡散モデル（軽量、約7GB）。`ComfyUI/models/diffusion_models/` に配置してください。

> [!TIP]
>
> 以前に Wan Video 関連のワークフローをご利用になったことがある場合、以下のモデルファイルはすでにダウンロード済みです。

**VAE**

> [card] [wan\_2.1\_vae.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/vae/wan_2.1_vae.safetensors)
>
> Wan VAE モデル。`ComfyUI/models/vae/` に配置してください。

**Text Encoders**（いずれか1つのバージョンを選択）

> [card] [umt5\_xxl\_fp16.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp16.safetensors)
>
> フル精度テキストエンコーダー（高品質、大容量）。`ComfyUI/models/text_encoders/` に配置してください。

> [card] [umt5\_xxl\_fp8\_e4m3fn\_scaled.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/blob/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors)
>
> FP8 テキストエンコーダー（VRAM使用量を低減）。`ComfyUI/models/text_encoders/` に配置してください。

ファイルの保存先：

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └─── wan2.1_vace_14B_fp16.safetensors
│   ├── 📂 text_encoders/
│   │   └─── umt5_xxl_fp8_e4m3fn_scaled.safetensors # または umt5_xxl_fp16.safetensors
│   └── 📂 vae/
│       └──  wan_2.1_vae.safetensors
```

### モデルの読み込み

本ドキュメントで扱うワークフローでは、使用するモデルが共通であり、ワークフロー自体も同一であるため、各ワークフローにおいて異なる入力を有効／無効にするためにノードの Bypass を切り替えるだけです。以下の画像を参考に、それぞれのワークフローで対応するモデルが正しく読み込まれていることを確認してください。

![Wan2.1 VACE モデル読み込み](https://mintcdn.com/dripart/SIDaLac8vBogzwm7/images/tutorial/video/wan/wan-vace-model-loading.jpg?fit=max\&auto=format\&n=SIDaLac8vBogzwm7\&q=85\&s=d46629d2ee7cfa1b942d4d92217992b1)

1. `Load Diffusion Model` ノードが `wan2.1_vace_14B_fp16.safetensors` を読み込んでいることを確認してください
2. `Load CLIP` ノードが `umt5_xxl_fp8_e4m3fn_scaled.safetensors` または `umt5_xxl_fp16.safetensors` を読み込んでいることを確認してください
3. `Load VAE` ノードが `wan_2.1_vae.safetensors` を読み込んでいることを確認してください

### ノードの Bypass 状態を切り替える方法

ノードが Bypass 状態に設定されている場合、そのノードを通過するデータはノードの処理を受けず、そのまま出力されます。ノードをワークフローから削除せずに一時的に無効化したい場合などに、Bypass 状態を設定することがよくあります。

以下は、ノードの Bypass 状態を切り替える3つの方法です：

![Bypass の切り替え](https://mintcdn.com/dripart/qYv6P0RgI3co7-eH/images/interface/nodes/cancel-bypass.jpg?fit=max\&auto=format\&n=qYv6P0RgI3co7-eH\&q=85\&s=3a57352f6bc6f1c16ce0792d384d16fd)

1. ノードを選択した状態で、選択ツールボックスの「インジケーター」セクションにある矢印アイコンをクリックすると、ノードの Bypass 状態をすばやく切り替えることができます
2. ノードを選択した状態で、ノードを右クリックし、`モード（Mode）` → `常に（Always）` を選択して、Always モードに切り替えます
3. ノードを選択した状態で、ノードを右クリックし、`Bypass（バイパス）` オプションを選択して、Bypass 状態を切り替えます

***

## 1. VACE テキストから動画へ（Text-to-Video）

**機能説明:** Wan2.1 VACE 14B モデルを使用して、テキストの説明を高品質な動画に変換します。480p と 720p の両方の解像度に対応しています。

### Wan2.1 VACE Text to Video

テキストの説明を高品質な動画に変換します。VACE-14B モデルで 480p と 720p の両方をサポートします。

![Wan2.1 VACE Text to Video ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_wan_vace_14B_t2v-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=video_wan_vace_14B_t2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=vace)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_vace_14B_t2v.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Wan2.1 VACE Text to Video」を検索

<video controls src="https://github.com/Comfy-Org/example_workflows/raw/refs/heads/main/video/wan/vace/vace-t2v.mp4" />

> [!TIP]
>
> MP4 ファイルからワークフローを読み込めない場合は、ComfyUI のフロントエンドが最新版であることを確認してください。[requirements.txt](https://github.com/Comfy-Org/ComfyUI/blob/master/requirements.txt) をご参照ください。MP4 ファイルからのワークフロー読み込みが可能であることを確認してください。
>
> 現在、requirements.txt に記載されている最新の ComfyUI フロントエンドバージョンは 1.19.9 です。

### 実行手順

![image](https://mintcdn.com/dripart/SIDaLac8vBogzwm7/images/tutorial/video/wan/wan-vace-t2v-step-guide.jpg?fit=max\&auto=format\&n=SIDaLac8vBogzwm7\&q=85\&s=6f24e0be5f1ee91ea5becd79501053bd)

画像中の番号順に操作を行い、ワークフローがスムーズに実行されるようご確認ください。

1. `CLIP Text Encode (Positive Prompt)` ノードにポジティブプロンプトを入力してください
2. `CLIP Text Encode (Negative Prompt)` ノードにネガティブプロンプトを入力してください
3. `WanVaceToVideo` ノードで画像サイズ（初回実行には 640x640 が推奨）とフレーム数（動画の長さ）を設定してください
4. `Run` ボタンをクリックするか、ショートカット `Ctrl(Cmd)+Enter` を押して動画生成を実行してください
5. 生成後、動画は自動で `ComfyUI/output/video` ディレクトリに保存されます（サブフォルダの場所は `動画を保存` ノードの設定によって異なります）

> [!TIP]
>
> 4090 GPU でテストした結果:
>
> * 720x1280 解像度、81 フレーム生成: 約 40 分
> * 640x640 解像度、49 フレーム生成: 約 7 分
>
> ただし、720P の動画品質の方が優れています。

***

## 2. VACE 画像から動画へ

**機能:** 参照画像のスタイルとコンテンツに一致する動画を生成します。スタイルを一貫させた動画生成に最適です。

上記のワークフローを引き続き使用できます。**参照画像の読み込み**内の`Load image`ノードのバイパスを解除して、画像を入力してください。以下の画像を使用することもできます。このファイルでは、対応するパラメータは既に設定されています。

### Wan2.1 VACE 参照から動画へ

参照画像のスタイルとコンテンツに一致する動画を作成します。スタイルを一貫させた動画生成に最適です。

![Wan2.1 VACE 参照から動画へのワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_wan_vace_14B_ref2v-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=video_wan_vace_14B_ref2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=vace)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_vace_14B_ref2v.json)
>
> JSONをダウンロード、またはテンプレートライブラリで「Wan2.1 VACE 参照から動画へ」を検索してください

<video controls src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/video/wan/vace/i2v/vace_i2v.mp4" />

**入力素材**

このファイルを対応する`LoadImage`ノードにアップロードしてください:

> [card] [video\_wan\_vace\_14B\_ref2v\_reference\_image.jpg](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/video_wan_vace_14B_ref2v_reference_image.jpg)
>
> `LoadImage` node 73 · `video_wan_vace_14B_ref2v_reference_image.jpg`

![video\_wan\_vace\_14B\_ref2v\_reference\_image.jpg](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/video_wan_vace_14B_ref2v_reference_image.jpg)

### 実行手順

![ワークフローステップ](https://mintcdn.com/dripart/SIDaLac8vBogzwm7/images/tutorial/video/wan/wan-vace-i2v-step-guide.jpg?fit=max\&auto=format\&n=SIDaLac8vBogzwm7\&q=85\&s=e22bf953a5900de76c55ed9af3881ea3)

画像の番号付きの手順に従って、スムーズなワークフロー実行を確保してください。

1. `Load image`ノードに対応する画像を入力してください
2. テキストから動画へのワークフローと同様に、プロンプトを修正・編集できます
3. `WanVaceToVideo`で画像の寸法（初回実行は640x640の解像度推奨）とフレーム数（動画の長さ）を設定してください
4. `Run`ボタンをクリックするか、ショートカット`Ctrl(cmd) + Enter`を使用して動画生成を実行してください
5. 生成後、動画は自動的に`ComfyUI/output/video`ディレクトリに保存されます（サブフォルダの場所は`save video`ノードの設定によります）

> [!TIP]
>
> 画像の寸法を取得するようなノードを使用して解像度を設定したいかもしれませんが、該当ノードの幅と高さのステップ要件により、画像の寸法が16で割り切れない場合、エラーメッセージが表示されることがあります。

### 補足事項

VACEは、1つの画像に複数の参照画像を入力して対応する動画を生成することもサポートしています。関連する例はVACEプロジェクトの[ページ](https://ali-vilab.github.io/VACE-Page/)でご覧いただけます。

***

## 3. VACE 動画から動画へ

**機能:** Wan VACEを使用して入力ビデオと参照画像を制御することで動画を生成します。参照素材を通じてビデオのスタイルと動きを制御します。

### Wan2.1 VACE Control Video

Wan VACEを使用して入力ビデオと参照画像を制御することで動画を生成します。

![Wan2.1 VACE Control Video ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_wan_vace_14B_v2v-1.webp)

> [card] [Comfy Cloudで実行](https://cloud.comfy.org/?template=video_wan_vace_14B_v2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=vace)
>
> Comfy Cloudで開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_vace_14B_v2v.json)
>
> JSONをダウンロードするか、テンプレートライブラリで「Wan2.1 VACE Control Video」を検索してください

<video controls src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/video/wan/vace/v2v/vace_v2v.mp4" />

次の素材を入力として使用します：

> [card] [参照画像](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_14B_v2v_reference_image.jpg)
>
> スタイルとコンテンツのための参照画像を入力します。

> [card] [制御ビデオ（前処理済み）](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_14B_v2v_reference_image_control_video.mp4)
>
> 前処理済みの制御ビデオ（深度）。**制御ビデオを読み込む**の下の`Load Video`で直接使用します。

1. 参照用の入力画像：

![v2v-input](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/video/wan/vace/v2v/input.jpg)

2. 以下のビデオは前処理済みで、ビデオ生成の制御に使用されます：

<video controls src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/video/wan/vace/v2v/post+depth.mp4" />

3. 以下のビデオはオリジナルビデオです。これらの素材をダウンロードし、[comfyui\_controlnet\_aux](https://github.com/Fannovel16/comfyui_controlnet_aux)のような前処理ノードを使用して画像を前処理できます：

<video controls src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/video/wan/vace/v2v/original.mp4" />

### 実行手順

![ワークフローの手順](https://mintcdn.com/dripart/SIDaLac8vBogzwm7/images/tutorial/video/wan/wan-vace-v2v-step-guide.jpg?fit=max\&auto=format\&n=SIDaLac8vBogzwm7\&q=85\&s=a59e79204a1faf9b3f63c482b65df764)

画像内の番号付き手順に従って、ワークフローがスムーズに実行されるようにしてください：

1. **参照画像を読み込む**の下の`Load Image`ノードに参照画像を入力します。
2. **制御ビデオを読み込む**の下の`Load Video`ノードに制御ビデオを入力します。提供されたビデオは前処理済みのため、追加の処理は不要です。
3. オリジナルビデオを自分で前処理する必要がある場合は、**画像前処理**グループを変更するか、`comfyui_controlnet_aux`ノードを使用して前処理を完了できます。
4. プロンプトを変更します。
5. `WanVaceToVideo`で画像の寸法（初回実行時は640x640の解像度を推奨）とフレーム数（再生時間）を設定します。
6. `Run`ボタンをクリックするか、ショートカット`Ctrl(cmd) + Enter`を使用してビデオ生成を実行します。
7. 生成後、ビデオは自動的に`ComfyUI/output/video`ディレクトリに保存されます（サブフォルダーの場所は`save video`ノードの設定によって異なります）。

***

## 4. VACE インペインティング

**機能:** 動画内の特定領域を編集し、周囲のコンテンツはそのまま保持します。オブジェクトの削除や置き換えに最適です。

### Wan2.1 VACE インペインティング

動画内の特定領域を編集し、周囲のコンテンツはそのまま保持します。オブジェクトの削除や置き換えに最適です。

![Wan2.1 VACE インペインティング ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_wan_vace_inpainting-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=video_wan_vace_inpainting\&utm_source=docs\&utm_medium=referral\&utm_campaign=vace)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_vace_inpainting.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Wan2.1 VACE インペインティング」を検索してください

**入力素材**

> [card] [入力ビデオ](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_inpainting_input_video.mp4)
>
> インペインティング用の入力ビデオ。`ビデオを読み込む`ノードで読み込みます。

> [card] [最初のフレームとマスク](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_inpainting_1st_frame_and_mask.png)
>
> インペインティング領域のマスクオーバーレイ付き最初のフレーム。

> [card] [参照画像](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_inpainting_reference_image.jpg)
>
> インペインティングコンテンツの参照画像。

\[更新予定]

***

## 5. VACE ビデオアウトペインティング

**機能:** Wan VACE アウトペインティングを使用してビデオサイズを拡大し、拡張動画を生成します。

### Wan2.1 VACE アウトペインティング

Wan VACE アウトペインティングを使用してビデオサイズを拡大し、拡張動画を生成します。

![Wan2.1 VACE アウトペインティングワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_wan_vace_outpainting-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=video_wan_vace_outpainting\&utm_source=docs\&utm_medium=referral\&utm_campaign=vace)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_vace_outpainting.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Wan2.1 VACE Outpainting」を検索

**入力素材**

> [card] [入力ビデオ](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_outpainting_input_video.mp4)
>
> アウトペインティング用の入力ビデオ。`Load Video` ノードで読み込みます。

\[更新予定]

***

## 6. VACE 先頭・最終フレーム動画生成

**機能:** 開始フレームと終了フレームを指定して、スムーズな動画トランジションを生成します。カスタムキーフレームシーケンスに対応。

### Wan2.1 VACE 先頭・最終フレーム

開始フレームと終了フレームを指定して、スムーズな動画トランジションを生成します。カスタムキーフレームシーケンスに対応。

![Wan2.1 VACE 先頭・最終フレーム ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_wan_vace_flf2v-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=video_wan_vace_flf2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=vace)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_vace_flf2v.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Wan2.1 VACE First-Last Frame」を検索

**入力素材**

> [card] [開始フレーム](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_flf2v_start_image.png)
>
> 開始フレーム画像。`Load Image` ノードで読み込みます。

> [card] [終了フレーム](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/refs/heads/main/input/video_wan_vace_flf2v_end_image.png)
>
> 終了フレーム画像。`Load Image` ノードで読み込みます。

先頭フレームと最終フレームを有効にするためには、動画の `length` 設定が `length-1` が4で割り切れる値である必要があります。

対応する `Batch_size` 設定は `Batch_size = length - 2` を満たす必要があります。

\[更新予定]


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.