モデルプレビューオーバーライド(ModelPreviewOverrideKJ)

モデルプレビューオーバーライドノード（クラスModelPreviewOverrideKJ）は、ComfyUIのデフォルトの512px制限を回避して、ノード上に専用のライブプレビューフレームを直接追加します。これは、ピクセル空間モデル（Chroma Radiance、ZImage、HiDream-O1など）の中間結果をサンプラー解像度のまま表示するときに特に便利です。また、ビデオモデル向けのアニメーションWebPプレビューをサポートし、ワークフローをすっきりさせるために標準のサンプラーノードプレビューオーバーレイを非表示にすることもできます。

入力

model（MODEL、必須）

プレビューオーバーライドを適用するモデルです。サンプリングの各ステップで、このノードにライブプレビューが生成されます。

max_resolution（INT、デフォルト1024、範囲0～8192、ステップ8）

ライブプレビューウィジェットの最大辺長（ピクセル単位）。

• 0 – ダウンスケールなし。プレビューはサンプラーのフル解像度でレンダリングされます（高解像度の場合は注意して使用してください）。
• 正の値 – プレビューの長辺がこのサイズにクランプされ、短辺は比例してスケーリングされます。

jpeg_quality（INT、デフォルト80、範囲30～100、ステップ1）

プレビュー画像をDOMウィジェットに転送する際のJPEG品質です。値を高くすると品質は向上しますがペイロードが大きくなり、低くするとオーバーヘッドが減りますが圧縮アーティファクトが目立ちます。

suppress_default_preview（BOOLEAN、デフォルトtrue）

有効にすると、サンプリング中に標準のサンプラーノードプレビューオーバーレイが非表示になり、このノードのフレームのみが更新されます。進捗バーは通常通り進みます。デフォルトのComfyUIプレビューをノードのライブフレームと一緒に表示したい場合は無効にします。

preview_frames（INT、デフォルト1、範囲1～1024、ステップ1）

アニメーションプレビューのために、各ビデオステップの潜在変数からサンプリングするフレーム数です。

• 1 – 単一フレーム（現在の動作、最速）。
• 2～1024 – サンプリングされたフレームからアニメーションWebPを生成し、preview_fpsで設定されたFPSで再生します。 この入力はビデオモデル（5D潜在変数）にのみ有効です。画像モデルでは無視されます。

preview_fps（INT、デフォルト12、範囲1～60、ステップ1）

アニメーションWebPプレビューの再生フレームレートです。preview_framesが1の場合は無視されます。

vae（VAE、オプション）

潜在変数を真のRGBプレビューにデコードするためのオプションのVAEです。

• TAEHV-LTX – 高速で小さなデコードを使用します（VAEはGPUにピン留めされます）。
• その他のLTX VAE – vae.decode()を介してフル品質のデコードを実行します。これはステップごとに大幅に遅くなります。 指定しない場合、ノードはモデルのデフォルトVAE（利用可能な場合）または標準のデコード方法にフォールバックします。

出力

MODEL

model入力に渡されたモデルそのままです。このノードはパススルーであり、プレビュー機能を追加しますが、モデルやその出力は変更しません。

使用上の注意

• ライブプレビューフレームはノード上の自己完結型ウィジェットとして表示されるため、サンプラーノードのプレビューが非表示の場合やsuppress_default_previewが有効な場合でも表示され続けます。
• ビデオモデルの場合、preview_framesを1より大きい値に設定すると、サンプリング中にアニメーションプレビューが表示されます。ステップごとに複数のフレームを抽出すると、メモリと計算のオーバーヘッドが増加することに注意してください。
• オプションのVAEを使用する場合、速度と品質のトレードオフはVAEの種類によって制御されます。TAEHV-LTXは速度を優先し、その他のLTX VAEは忠実度を優先します。