デコードしてビデオを保存(DecodeAndSaveVideo)

説明

デコードしてビデオを保存ノードは、潜在表現からビデオフレームとオプションのオーディオをデコードし、結合して結果のビデオをファイルに直接保存します。メモリ効率を考慮して設計されており、デコードされたフレームは生成と同時にディスクに書き込まれ、すべての中間画像をRAMに保持することはありません。これにより、長尺や高解像度のビデオでも、メモリ不足になることなく処理できます。

このノードは、ビデオフレームの潜在表現（通常はビデオ拡散モデルによって生成される）と、オプションでオーディオの潜在表現を受け取ります。ビデオ潜在をデコードするためのVAEモデル（video_vae）と、オーディオ潜在をデコードするためのVAEモデル（audio_vae – audio_latentが指定された場合のみ必須）の2つを別々に提供する必要があります。また、タイルデコード（空間的および時間的）をサポートしており、メモリ使用量をさらに削減できます（タイルパラメータで設定可能）。

このノードをビデオ生成パイプラインの最終ステップとして使用し、結果を一般的なビデオコンテナ形式でエクスポートします。

入力

タイルの動作

• tilingが無効の場合、フレーム全体が一度にデコードされます – これが最もメモリを消費します。
• 空間タイル（tiling = "spatial"または"both"）は、各フレームをtile_size×tile_sizeの小さなタイルに分割し、それぞれ独立してデコードし、オーバーラップ領域をブレンドします。
• 時間タイル（tiling = "temporal"または"both"）は、フレームシーケンスをtemporal_sizeフレームのチャンクに分割し、各チャンクはtemporal_overlapフレームだけオーバーラップします。時間分解能をサポートするVAE（一部のビデオVAEなど）にのみ適用可能です。
• ノードはオーバーラップ領域とタイル境界のブレンドを自動的に処理します。

出力

このノードには出力コネクションはありません。デコードされたビデオは、filename_prefixから構築されたパスを使用して直接ディスクに書き込まれます。ノードはワークフローにデータを返しません。

使用上の注意

• メモリ管理: ノードはデコードされたフレームを生成と同時にディスクにストリーミングします。タイルを無効にしても、すべてのフレームが同時にメモリに蓄積されることはありません。タイルはさらにピークメモリを削減しますが、デコード速度は低下します。
• オーディオ: オーディオを含めるには、audio_latentとaudio_vaeの両方を指定します。オーディオVAEはオーディオ潜在空間（例：オーディオ拡散モデルからのもの）と一致している必要があります。オーディオ潜在が接続されていない場合、出力ビデオは無音になります。
• フォーマットとコーデックのサポート: 利用可能なフォーマットとコーデックは、システムのFFmpeg（またはその他のエンコーダ）のインストール状況に依存します。手間をかけずに使うにはautoを使用してください。特定のコーデックやコンテナが必要な場合は、必要なエンコーダがインストールされていることを確認してください。
• ファイル名プレフィックストークン: ComfyUIの書式構文を使用して、日付、時刻、ノード値を含めることができます。例：
  video/ComfyUI_%empty_latent_image.width%x%empty_latent_image.height%_%date:yyyy-MM-dd%
  とすると、video/ComfyUI_512x512_2025-01-15_0001.mp4のようなファイル名が生成されます。
• タイルサイズの調整: ほとんどのユースケースでは、tile_sizeを512、overlapを64に設定すると、メモリと速度のバランスが良好です。メモリに余裕があればtile_sizeを大きく、VRAMが不足する場合は小さくしてください。
• 時間タイル: これは、時間タイルをネイティブでサポートするVAEでのみ有効です。VAEがサポートしていない場合、時間パラメータを設定しても効果はありません。
• ステップ刻み: すべての整数タイルパラメータは、ノードで定義されたステップサイズ（空間は32、時間は4）を強制します。ステップに一致しない値は自動的に丸められます。