Leapfusion Hunyuan I2V Patcher (LeapfusionHunyuanI2V) - ComfyUI-KJNodes

Leapfusion Hunyuan I2V Patcher ノードは、入力されたモデルを"パッチ"することでその機能を実現します。

Leapfusion Hunyuan I2V Patcher は、ビデオ生成と編集のための高度なノードです。その中核機能は、拡散モデルのノイズ除去プロセス中の動作を変更することにあり、ユーザーが指定した潜在画像でビデオシーケンス内の特定のフレームを置き換えることを可能にし、生成されるビデオコンテンツを精密に制御できるようにします。

ノード機能

このノードは、入力されたモデルを"パッチ"することでその機能を実現します。モデルがノイズ除去サンプリングステップを実行する際に介入し、ユーザーが設定した開始パーセンテージ（start_percent）と終了パーセンテージ（end_percent）に基づいて、特定のノイズ除去段階において、ターゲットフレーム（indexで指定）の潜在表現をユーザーが提供したlatentで置き換えます。この置き換えの強度はstrengthパラメータで調整可能で、負の値もサポートされ、逆方向のガイダンスを実現できます。

ノードパラメータ説明 - Leapfusion Hunyuan I2V Patcher

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`model`	MODEL	はい	-	-	model（入力パラメータ）：パッチが必要な元の拡散モデルを受け取ります。このパラメータは、後続の操作の基盤となるモデルを定義します。
`latent`	LATENT	はい	-	-	latent（入力パラメータ）：ビデオ内の特定フレームを置き換えるために使用される潜在画像表現を提供します。このデータは、他のパラメータ設定に基づいて生成プロセスに注入されます。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`index`	INT	はい	0	-1 - 1000 (ステップ: 1)	置き換えられる潜在表現のインデックス。0は最初のフレーム、-1は最後のフレームを示します。
`start_percent`	FLOAT	はい	0.0	0.0 - 1.0 (ステップ: 0.01)	適用を開始するステップのパーセンテージ
`end_percent`	FLOAT	はい	1.0	0.0 - 1.0 (ステップ: 0.01)	適用を終了するステップのパーセンテージ
`strength`	FLOAT	はい	1.0	-10.0 - 10.0 (ステップ: 0.001)	strength（入力パラメータ）：潜在画像置き換え効果の強度係数を制御します。範囲は -10.0 から 10.0、ステップは 0.001 です。正の値は置き換えを強化し、負の値は逆効果をもたらす可能性があります。

出力 (Output)

パラメータ名	データ型	説明
MODEL	MODEL	MODEL（出力パラメータ）：パッチ適用後の新しいモデルを出力します。特定フレームの置き換えロジックが含まれています。

使用シナリオ

画像からビデオ（I2V）やビデオフレーム補間のワークフローで、このノードを使用できます。例えば、ビデオシーケンスを生成した後、その中の特定のフレーム（最初や最後のフレームなど）を修正したい場合、独立した画像の潜在表現をロードし、このノードを通じて元のビデオ生成プロセスに"注入"することで、そのフレームの最終的な外観を変更しつつ、ビデオ全体の一貫性を維持することができます。

注意事項

このノードは実験的カテゴリに属し、その動作は具体的なモデルアーキテクチャとサンプラーの設定に大きく依存する可能性があります。使用時は、indexパラメータの有効範囲、およびstrengthパラメータの設定が不適切だと映像が不安定になる可能性があることに注意してください。

Leapfusion Hunyuan I2V Patcher ノードソースコードリンク

Leapfusion Hunyuan I2V Patcher ノードは ComfyUI-KJNodes ノードパッケージから提供されています。

Leapfusion Hunyuan I2V Patcher(LeapfusionHunyuanI2V)