WanVideo Tea Cache (native) (WanVideoTeaCacheKJ) - ComfyUI-KJNodes

WanVideo Tea Cache (native) ノードは、入力されたモデルを修正（パッチ適用）することで機能を実現します。このノードは非推奨です。代わりにネイティブのEasyCacheノード、または別の最新の代替ノードを使用してください。

WanVideo Tea Cache (native) ノードは、WanVideo モデルの推論プロセスを高速化するための最適化ツールです。その中核機能は、中間計算結果をキャッシュし、特定の条件を満たした時にそのキャッシュを再利用することで、一部の計算ステップをスキップし、動画生成や処理の効率を大幅に向上させることです。

ノード機能

このノードは、入力されたモデルを修正（パッチ適用）することで機能を実現します。その中核メカニズムは、相対 L1 距離の閾値に基づいてキャッシュを適用するタイミングを判断するもので、生成速度と結果の正確性の間のトレードオフ戦略です。ノードは、異なる WanVideo モデルバリアント（例：1.3B、14B）に対して、キャッシュ判断の正確性を最適化するためのプリセットスケーリング係数の選択をサポートしており、また、係数を手動で無効にしてより基本的な調整を行うことも可能です。

ノードパラメータ説明 - WanVideo Tea Cache (native)

入力接続 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`model`	MODEL	はい	-	-	model（出力パラメータ）：TeaCache 最適化戦略が適用されたモデルを出力します。後続のサンプラーノードで使用できます。

コントロールパラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`cache_device`	COMBO	はい	offload_device	"main_device", "offload_device"	cache_device（入力パラメータ）：キャッシュデータを格納するデバイスを選択します。"main_device"（メインデバイス）または"offload_device"（オフロードデバイス）を選択でき、メモリやVRAMの使用を管理します。
`coefficients`	COMBO	はい	i2v_480	"disabled", "1.3B", "14B", "i2v_480", "i2v_720"	coefficients（入力パラメータ）：相対 L1 距離の再スケーリングに使用するプリセット係数を選択します。オプションは"disabled"（無効）および異なるモデル（1.3B, 14B）や解像度（i2v_480, i2v_720）向けのプリセットです。無効時はより小さい閾値を使用する必要があります。
`rel_l1_thresh`	FLOAT	はい	0.275	0.0 - 10.0 (ステップ: 0.001)	キャッシュを適用するタイミングを決定する閾値。速度と精度の間の妥協点です。係数を使用する場合、1.3Bモデルを除くすべてのモデルでは0.2-0.4の間が良い値の範囲です。1.3Bモデルは約10分の1（係数を使用しない場合と同様）にする必要があります。
`start_percent`	FLOAT	はい	0.1	0.0 - 1.0 (ステップ: 0.01)	TeaCache を使用するステップの開始パーセンテージ。
`end_percent`	FLOAT	はい	1.0	0.0 - 1.0 (ステップ: 0.01)	TeaCache を使用するステップの終了パーセンテージ。

出力 (Outputs)

パラメータ名	データ型	説明
model	MODEL	model（出力パラメータ）：TeaCache 最適化戦略が適用されたモデルを出力します。後続のサンプラーノードで使用できます。

使用シナリオ

動画生成ワークフローでは、このノードは通常、KSampler や類似のサンプラーの前に接続されます。例えば、WanVideo モデルを使用して一貫性のある動画を生成する際、ユーザーはまずモデルをこのノードで処理し、閾値や開始・終了パーセンテージを調整することで、動きの滑らかさを保証しつつ、一部のサンプリングステップをスキップし、動画シーケンス全体の生成速度を向上させることができます。

注意事項

このノードは「非推奨」としてマークされています。これは、将来の ComfyUI または関連プラグインのバージョンで、この機能がメンテナンスされなくなったり提供されなくなったりする可能性があることを意味します。ユーザーは代替案に留意することをお勧めします。推奨される代替案は、ネイティブのEasyCacheノード、または別の最新のカスタムノードです。使用時には、初期のステップ（開始パーセンテージが小さすぎる場合など）はスキップすべきではなく、そうしないと生成される動画の動的効果が損なわれる可能性があることに注意してください。

WanVideo Tea Cache (native) ノードソースコードリンク

WanVideo Tea Cache (native) ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

WanVideo Tea Cache (native)(WanVideoTeaCacheKJ)

Wan Video Tea Cache KJ