> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Wan2.1 Fun Control 動画示例

> 本ガイドでは、ComfyUI で Wan2.1 Fun Control を使用して制御動画で動画を生成する方法を説明します

## Wan2.1-Fun-Control について

**Wan2.1-Fun-Control** は、アリババチームによって開発されたオープンソースの動画生成・制御プロジェクトです。
革新的な制御コード（Control Codes）メカニズムを導入し、深層学習とマルチモーダル条件入力を組み合わせることで、事前設定された制御条件に準拠した高品質な動画を生成します。このプロジェクトは、マルチモーダル制御条件を通じて生成される動画コンテンツを正確に誘導することに焦点を当てています。

現在、Fun Control モデルは**Canny（線画）**、**Depth（深度）**、**OpenPose（人体姿勢）**、**MLSD（幾何エッジ）**、**軌道制御**を含むさまざまな制御条件をサポートしています。
また、モデルは 16 フレーム/秒で 512、768、1024 の解像度オプションを持つ多解像度動画予測をサポートし、最大 81 フレーム（約 5 秒）の長さの動画を生成できます。

モデルバージョン：

* **1.3B** 軽量版：ローカルデプロイメントと高速推論に適しており、**VRAM 要件が低い**
* **14B** 高性能版：モデルサイズは 32GB+ に達し、より良い結果を提供しますが、**より高い VRAM が必要**

関連コードリポジトリはこちら：

* [Wan2.1-Fun-1.3B-Control](https://huggingface.co/alibaba-pai/Wan2.1-Fun-1.3B-Control)
* [Wan2.1-Fun-14B-Control](https://huggingface.co/alibaba-pai/Wan2.1-Fun-14B-Control)
* コードリポジトリ：[VideoX-Fun](https://github.com/aigc-apps/VideoX-Fun)

ComfyUI は現在、Wan2.1 Fun Control モデルを**ネイティブサポート**しています。このチュートリアルを開始する前に、[このコミット](https://github.com/comfyanonymous/ComfyUI/commit/3661c833bcc41b788a7c9f0e7bc48524f8ee5f82) 以降のバージョンを使用していることを確認するために、ComfyUI を更新してください。

本ガイドでは、2 つのワークフローを提供します：

1. ネイティブの Comfy Core ノードのみを使用するワークフロー
2. カスタムノードを使用するワークフロー

<Tip>
  現在のネイティブノードの動画サポートの制限により、ネイティブのみのワークフローは、ユーザーがカスタムノードをインストールせずにプロセスを完了できるように保証します。
  ただし、動画生成の良いユーザー体験を提供することは、カスタムノードなしでは困難であることがわかっているため、本ガイドでは両方のワークフローバージョンを提供しています。
</Tip>

<Tip>
  <Tabs>
    <Tab title="ポータブル版または自宅サーバーで実行しているユーザー">
      ComfyUI が最新版に更新されていることを確認してください。

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

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

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

      1. 最新の ComfyUI（Nightly 版）を使用していない
      2. 起動時に一部のノードのインポートに失敗している
    </Tab>

    <Tab title="デスクトップ版またはクラウド版ユーザー">
      * デスクトップ版は ComfyUI の安定版（Stable Release）をベースとしており、新しいデスクトップ安定版がリリースされると自動的に更新されます。
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントで記載されているコアノードのうち、一部が利用できない場合は、そのノード機能がまだ最新の安定版に含まれていないためです。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

## モデルインストール

これらのモデルは一度だけインストールする必要があります。ワークフロー画像にもモデルダウンロード情報が含まれているため、お好みのダウンロード方法を選択できます。

以下のモデルは [Wan\_2.1\_ComfyUI\_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) と [Wan2.1-Fun](https://huggingface.co/collections/alibaba-pai/wan21-fun-67e4fb3b76ca01241eb7e334) で見つかります

対応するリンクをクリックしてダウンロードしてください。以前に Wan 関連のワークフローを使用したことがある場合は、**Diffusion models** のみをダウンロードする必要があります。

**Diffusion models** - 1.3B または 14B を選択。14B バージョンはファイルサイズが大きく（32GB）、VRAM 要件も高くなります：

* [wan2.1\_fun\_control\_1.3B\_bf16.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/diffusion_models/wan2.1_fun_control_1.3B_bf16.safetensors?download=true)
* [Wan2.1-Fun-14B-Control](https://huggingface.co/alibaba-pai/Wan2.1-Fun-14B-Control/blob/main/diffusion_pytorch_model.safetensors?download=true)：ダウンロード後に `Wan2.1-Fun-14B-Control.safetensors` にリネームしてください

**Text encoders** - 以下のモデルのいずれかを選択（fp16 精度はサイズが大きく、パフォーマンス要件が高くなります）：

* [umt5\_xxl\_fp16.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/text_encoders/umt5_xxl_fp16.safetensors?download=true)
* [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?download=true)

**VAE**

* [wan\_2.1\_vae.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/vae/wan_2.1_vae.safetensors?download=true)

**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?download=true)

ファイル保存場所：

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── wan2.1_fun_control_1.3B_bf16.safetensors
│   ├── 📂 text_encoders/
│   │   └─── umt5_xxl_fp8_e4m3fn_scaled.safetensors
│   └── 📂 vae/
│   │   └── wan_2.1_vae.safetensors
│   └── 📂 clip_vision/
│       └──  clip_vision_h.safetensors                 
```

## ComfyUI ネイティブワークフロー

このワークフローでは、`Load Image` ノードが現在 mp4 形式をサポートしていないため、**WebP 形式**に変換された動画を使用します。また、元の動画の事前処理に**Canny Edge**を使用します。
多くのユーザーがカスタムノードのインストール時にインストール失敗や環境問題に遭遇するため、このバージョンのワークフローはよりスムーズな体験を保証するためにネイティブノードのみを使用します。

機能豊富なノードを提供する強力な ComfyUI 作者に感謝します。関連バージョンを直接確認したい場合は、[カスタムノードを使用するワークフロー](#workflow-using-custom-nodes) を参照してください。

### 1. ワークフローファイルダウンロード

#### 1.1 ワークフローファイル

以下の画像をダウンロードし、ComfyUI にドラッグしてワークフローをロードしてください：

![Wan2.1 Fun Control ネイティブワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/wan2.1_fun_control_native.webp)

#### 1.2 入力画像と動画のダウンロード

入力用に以下の画像と動画をダウンロードしてください：

![入力参照画像](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/input/01-portrait_remix.png)

![入力参照動画](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/input/01-portrait_video.webp)

### 2. ワークフローを段階的に完了する

<img src="https://mintcdn.com/dripart-docs-recommend-assets-api/19pHMF3x9dkLUPc9/images/tutorial/video/wan/fun_control_native_flow_diagram.png?fit=max&auto=format&n=19pHMF3x9dkLUPc9&q=85&s=e790abe7f7b0f9153680a7ca5a5c2ba7" alt="Wan2.1 Fun Control ワークフロー手順" width="2201" height="1907" data-path="images/tutorial/video/wan/fun_control_native_flow_diagram.png" />

1. `Load Diffusion Model` ノードが `wan2.1_fun_control_1.3B_bf16.safetensors` をロードしていることを確認
2. `Load CLIP` ノードが `umt5_xxl_fp8_e4m3fn_scaled.safetensors` をロードしていることを確認
3. `Load VAE` ノードが `wan_2.1_vae.safetensors` をロードしていることを確認
4. `Load CLIP Vision` ノードが `clip_vision_h.safetensors` をロードしていることを確認
5. 開始フレームを `Load Image` ノード（`Start_image` にリネーム済み）にアップロード
6. 2 番目の `Load Image` ノードに制御動画をアップロード。注意：このノードは現在 mp4 をサポートしておらず、WebP 動画のみ使用可能
7. （オプション）プロンプトを変更（英語と中国語の両方をサポート）
8. （オプション）`WanFunControlToVideo` で動画サイズを調整し、過度に大きな寸法を避ける
9. `Run` ボタンをクリックするか、ショートカット `Ctrl(cmd) + Enter` を使用して動画生成を実行

### 3. 使用上の注意

* 制御動画と同じ数のフレームを `WanFunControlToVideo` ノードに入力する必要があるため、指定されたフレーム数が実際の制御動画フレーム数を超えると、余分なフレームが制御条件に準拠しないシーンを表示する可能性があります。この問題は [カスタムノードを使用するワークフロー](#workflow-using-custom-nodes) で解決します
* 過度に大きな寸法を設定しないでください。サンプリングプロセスが非常に時間がかかる可能性があります。まず小さな画像を生成してからアップスケールしてください
* このワークフローを基に、テキストから画像や他のタイプのワークフローを追加して、直接テキストから動画生成やスタイル転換を実現するために想像力を発揮してください
* より豊富な制御オプションのために [ComfyUI-comfyui\_controlnet\_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) などのツールを使用してください

## カスタムノードを使用するワークフロー

以下の 2 つのカスタムノードをインストールする必要があります：

* [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite)
* [ComfyUI-comfyui\_controlnet\_aux](https://github.com/Fannovel16/comfyui_controlnet_aux)

[ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) を使用して不足しているノードをインストールするか、各カスタムノードパッケージのインストール指示に従ってください。

### 1. ワークフローファイルダウンロード

#### 1.1 ワークフローファイル

以下の画像をダウンロードし、ComfyUI にドラッグしてワークフローをロードしてください：

![ワークフローファイル](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/wan2.1_fun_control_use_custom_nodes.webp)

<Note>
  動画ファイルのサイズが大きいため、[こちら](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/wan2.1_fun_control_use_custom_nodes.json) をクリックして JSON 形式のワークフローファイルをダウンロードすることもできます。
</Note>

#### 1.2 入力画像と動画のダウンロード

入力用に以下の画像と動画をダウンロードしてください：
![入力参照画像](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/input/02-robot's_eye.png)

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/wan2.1_fun_control/input/02-man's_eye.mp4" />

### 2. ワークフローを段階的に完了する

<img src="https://mintcdn.com/dripart-docs-recommend-assets-api/19pHMF3x9dkLUPc9/images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png?fit=max&auto=format&n=19pHMF3x9dkLUPc9&q=85&s=246274559c5075e4b7f174042c2db361" alt="カスタムノードを使用する Wan2.1 Fun Control ワークフロー手順" width="2201" height="1907" data-path="images/tutorial/video/wan/fun_control_using_custom_nodes_flow_diagram.png" />

> モデル部分は基本的に同じです。ネイティブのみのワークフローをすでに体験している場合は、対応する画像を直接アップロードして実行できます。

1. `Load Diffusion Model` ノードが `wan2.1_fun_control_1.3B_bf16.safetensors` をロードしていることを確認
2. `Load CLIP` ノードが `umt5_xxl_fp8_e4m3fn_scaled.safetensors` をロードしていることを確認
3. `Load VAE` ノードが `wan_2.1_vae.safetensors` をロードしていることを確認
4. `Load CLIP Vision` ノードが `clip_vision_h.safetensors` をロードしていることを確認
5. 開始フレームを `Load Image` ノードにアップロード
6. mp4 形式の動画を `Load Video(Upload)` カスタムノードにアップロード。ワークフローがデフォルトの `frame_load_cap` を調整していることに注意
7. 現在の画像の場合、`DWPose Estimator` は `detect_face` オプションのみを使用
8. （オプション）プロンプトを変更（英語と中国語の両方をサポート）
9. （オプション）`WanFunControlToVideo` で動画サイズを調整し、過度に大きな寸法を避ける
10. `Run` ボタンをクリックするか、ショートカット `Ctrl(cmd) + Enter` を使用して動画生成を実行

### 3. ワークフローの注意

ComfyUI コミュニティ作者のカスタムノードパッケージに感謝します：

* この例では mp4 動画をサポートするために `Load Video(Upload)` を使用
* `Load Video(Upload)` から取得した `video_info` により、出力動画の `fps` を同じに保つことができます
* `DWPose Estimator` を `ComfyUI-comfyui_controlnet_aux` ノードパッケージの他のプリプロセッサに置き換えることができます
* プロンプトは複数の言語をサポート

## 使用テクニック

<img src="https://mintcdn.com/dripart-docs-recommend-assets-api/19pHMF3x9dkLUPc9/images/tutorial/video/wan/apply_multi_control_videos.jpg?fit=max&auto=format&n=19pHMF3x9dkLUPc9&q=85&s=ad7c51c2b23f9294485c7086520a56d2" alt="複数の制御動画を適用" width="1726" height="1156" data-path="images/tutorial/video/wan/apply_multi_control_videos.jpg" />

* 有用なテクニックとして、複数の画像事前処理技術を組み合わせ、`Image Blend` ノードを使用して複数の制御方法を同時に適用する目標を達成できます。

* `ComfyUI-VideoHelperSuite` の `Video Combine` ノードを使用して、動画を mp4 形式で保存できます

* `SaveAnimatedWEBP` を使用するのは、現在**mp4** へのワークフロー埋め込みをサポートしておらず、一部のカスタムノードもワークフロー埋め込みをサポートしていない可能性があるためです。動画にワークフローを保存するために、`SaveAnimatedWEBP` ノードを選択します。

* `WanFunControlToVideo` ノードでは、`control_video` は必須ではないため、場合によっては制御動画を使用せずに、320x320 などの非常に小さな動画サイズを最初に生成し、それらを制御動画入力として使用して一貫した結果を達成できます。

* [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper)

* [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes)
