wuwukaka/ComfyUI-WanAnimatePlus

ComfyUI‑WanAnimatePlus

何であるか – ComfyUI のカスタムノードのコレクションで、WanVideo パイプラインを拡張します。マルチリファレンス画像のインジェクション、シームレスな動画接続、および新しい SCAIL‑2 と Bernini 動画生成モデルの完全なサポートを追加します。

なぜ重要か – オリジナルの WanVideo ワークフローは単一のリファレンス画像のみを許容し、複数の生成実行間で動画を簡単に継続できませんでした。WanAnimatePlus はこれらの制限を克服し、以下を可能にします：

• 最大 5 枚のリファレンス画像（prefix_frames）で生成をガイド。
• 前のセグメントの最後の 21 フレーム を入力することで、連続する動画セグメントを目に見えるカットなしで接続（transition_video）。
• Bernini モデルを、動画→動画、リファレンス動画→動画、リファレンス画像→動画、テキスト→動画のタスクに使用。
• SCAIL‑2 チェックポイントと連携し、リファレンス画像、ポーズストリーム、マスク、背景画像、2段階サンプリングを専用ノードで処理。

主な機能

機能	機能内容
prefix_frames	1〜5枚の追加リファレンス画像を受け取り、キャンバスを拡張し、それらをエンコード、自動的にポーズ/顔のオフセットを調整。
transition_video	前のクリップの最後の21フレームを取得し、生成キャンバスの先頭に書き込み、デコード後にトリムしてシームレスな継続を実現。
Bernini サポート	ソース動画、リファレンス動画、またはリファレンス画像からコンディショニングラテンスを生成；自動的にタスク（v2v, rv2v, r2v, t2v）を検出。
SCAIL‑2 エンベッド	リファレンス画像、ドライブポーズ、カラーポーズマスク、オプションのプレフィックス/トランジションラテンス、背景画像を SCAIL‑2 モデルが期待する形式に事前処理。
公式互換フロー・ノード	WanAnimatePlus SCAIL_2 Flow Embeds、Flow Sampler、VAE Decode は、通常の ComfyUI と同様の MODEL / VAE / CONDITIONING / LATENT / IMAGE インターフェースを公開し、SCAIL‑2 ワークフローを標準的なノード接続で構築可能。
シンプルサンプラー・ノード	WanAnimatePlus Easy Sampler と Easy SamplerSettings は、低レベルのサンプラー引数を隠蔽しつつ、内部では完全な WanAnimatePlus サンプラーを使用。
メモリヘルパー	force_offload や tiled_vae などのオプションにより、中程度のGPUでも重い動画モデルを実行可能。

一般的な使用例

• 複数の視覚的リファレンスを持つ、長く一貫性のある動画シーケンスの作成（例：キャラクターが複数のポーズで登場）。
• 既存のクリップを延長する（例：アニメーションを継続、動画の末尾を編集）。
• ソース動画の動きを新しい被写体に転送しながら、リファレンス画像もインジェクト。
• SCAIL‑2 モデルを使って、オプションの背景置き換えを伴う高品質なポーズ駆動アニメーションを実現。

インストール

# ComfyUI インストール内
cd ComfyUI/custom_nodes
git clone https://github.com/wuwukaka/ComfyUI-WanAnimatePlus.git
# 新しいノードが登録されるように ComfyUI を再起動

README には、元の ComfyUI‑WanVideoWrapper もインストールする必要があるとありますが、同じワークフロー内で WanAnimatePlus ノードと元の WanVideo ノードを混在させないでください。

クイックスタート・ワークフロー

1. ComfyUI を開く；新しいカテゴリ WanAnimatePlus が表示される。
2. 標準の WanVideo チェーンを WanAnimatePlus の同等物に置き換える：
   • WanAnimatePlus ModelLoader
   • WanAnimatePlus VAELoader
   • WanAnimatePlus ContextOptions
   • WanAnimatePlus AnimateEmbeds（現在は prefix_frames と transition_video 入力付き）
   • WanAnimatePlus Sampler / Easy Sampler
   • WanAnimatePlus Decode
3. オプションの入力を接続：
   • プレフィックスフレーム – 最大5枚のリファレンス画像。
   • トランジション動画 – 前のセグメントの最後の21フレーム。
   • SCAIL‑2 用：WanAnimatePlus SCAIL_2 Embeds（またはフロー版）とポーズ画像、マスクなどを併用。
4. ワークフローを実行。トランジションクリップを供給した場合、出力動画は先頭に追加されたフレームがトリムされ、スムーズな継続が得られる。

例リソース

• example_workflows/ – マルチリファレンス生成、動画継続、SCAIL‑2 使用を示す準備済みのJSONワークフロー。
• README に記載の RunningHub リンクから、無料クラウドインスタンスでワークフローを試すことができる（招待コードで1,000クレジットを獲得可能）。

プロジェクト構造 – リポジトリは典型的な ComfyUI カスタムノード構造を反映：コアノード定義（nodes.py, nodes_sampler.py）、モデルローダーヘルパー、コンテキストウィンドウスケジューリング、ユーティリティモジュール。すべての重い処理は wanvideo/ サブディレクトリにあり、元の WanVideo コードのフォークです。

ライセンスとクレジット – Apache‑2.0、上流の ComfyUI‑WanVideoWrapper およびその他のヘルパー・プロジェクトへのクレジットを含む NOTICE ファイルあり。

---

結論 – ComfyUI で動画生成を行っており、マルチリファレンス制御やシームレス接続が必要な場合、WanAnimatePlus は WanVideo パイプラインを拡張する即時利用可能なノードセットを提供し、公式 ComfyUI ノードエコシステムと互換性を保ちます。