VideoHelperSuite リファレンス:フレーム読み込み、音声、合成、保存出力
VHS_VideoCombine は生成コンテンツを取り巻くメディア処理層の例です。読み込み、フレームのサンプリング、合成、保存は、生成モデル自体と混同しないでください。
目的と対象範囲
VHS_VideoCombine は生成コンテンツを取り巻くメディア処理層の例です。読み込み、フレームのサンプリング、合成、保存は、生成モデル自体と混同しないでください。
出典から確認できること
README では、Load Video と Video Combine の FPS、形式、音声、保存に関するオプションを説明しています。2026年8月の特定の報告では、精度によって音声の挙動が変わるとされていますが、これは報告者のテスト結果であり、こちらで実施したものではありません。出典 1(英語) 出典 2(英語)
始める前に
1. 入力 FPS、強制サンプリング、フレームスキップ、上限によって、処理に渡されるフレームが決まります。
2. 最終的な frame_rate、音声、コーデック、ピクセル形式によって、出力ファイルが決まります。
3. 確認したノードソースでは、save_output=true は ComfyUI の出力ストレージを、false は一時ストレージを選びます。フロントエンドのプレビュー、ファイルの保存先、埋め込まれたワークフローのメタデータは別々に確認してください。再生できることは、グラフを復元できる証拠にはなりません。VHS ソース(英語)
手順と確認
以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。
手順 1. 大規模な生成モデルや複雑な音声エフェクトを追加する前に、短く有効な入力で読み込みと合成をテストします。
手順 2. 実際の入出力フレーム数と目標 FPS を記録し、想定した再生時間と保存ファイルを比較します。音声トラックの有無、長さ、音量はそれぞれ個別に確認します。動画プレビューだけでは、そのどれも確認できません。
手順 3. traceback 全体と FFmpeg の標準エラー出力を確認し、実行ファイルが見つからない場合と、コーデックや形式の引数が受け付けられない場合を区別します。音が正しくない場合は、上流の AUDIO と保存されたトラックを別々に調べます。標準エラー出力だけでは、波形サンプルが有限値でなかったことまでは確認できません。
手順 4. 依存関係を更新した後は、動画、音声、API の経路を個別に再検証し、ノードのバージョンと成功したサンプルの条件を記録しておきます。
完了の確認
実際のファイルパスと、一時ストレージか出力ストレージのどちらに保存されたかを確認します。その後、コンテナー、フレーム数、再生時間、音声をフロントエンドのプレビューとは別に調べます。ワークフローの復元が必要な場合は、再生できるファイルにグラフが含まれると決めつけず、メタデータか別のキャンバス書き出しを確認してください。
制限と注意点
固定した Comfy Registry 1.7.9 のアーカイブでは、VHS_VideoCombine の入力は次のように宣言されています。images(IMAGE。LATENT も受け付ける)、frame_rate(FLOAT/INT。デフォルト 8、最小値 1、刻み 1)、loop_count(INT。デフォルト 0、範囲 0~100)、filename_prefix(STRING。デフォルト AnimateDiff)、format、pingpong(false)、save_output(true)。任意入力は audio(AUDIO)、meta_batch(VHS_BatchManager)、vae(VAE)です。非表示の実行コンテキストは PROMPT、EXTRA_PNGINFO、UNIQUE_ID です。出力宣言は VHS_FILENAMES(名前は Filenames)、関数は combine_video、出力ノードは true です。
format は動的です。GIF/WebP は、インストール済みまたは登録済みの形式ファイルから検出される FFmpeg 形式と組み合わされるため、このアーカイブだけではお使いのマシンで選べる形式を特定できません。これは固定したソースの AST のみを解析した結果であり、ライブの object_info や実行時テストではありません。対象はこの 1 ノードのみで、残り 39 クラスのインターフェースは収集していません。読み取り専用の 1.7.9 静的インターフェース記録には、アーカイブとソースファイルのハッシュが記載されています。リポジトリ内のコピーは docs/VHS-1.7.9-STATIC-INTERFACE.json です。
参照した原文資料
- VideoHelperSuite README(英語)(確認日:2026-09-26)
- fp16 中間値での VHS 音声 dtype の報告(英語)(確認日:2026-09-26)
- 現在の VideoHelperSuite ノードソース(英語)(確認日:2026-09-26)
- Comfy Registry 1.7.9 ソースアーカイブ(英語)(SHA-256 の再確認日:2026-09-26)
ソース、静的インターフェース、英語原文の確認日:2026-09-26。VHS の実行、動画書き出し、GPU 実行、実行時の保証は行っていません。
関連するトラブルシューティング記事とガイド
VHS_VideoCombine
images:IMAGE 入力(LATENT も受け付ける) + frame_rate:FLOAT/INT。デフォルト 8、最小値 1、刻み 1 + loop_count:INT。デフォルト 0、範囲 0~100 + filename_prefix:STRING。デフォルト AnimateDiff + format:組み込みの image/gif と image/webp に加え、動的に検出される FFmpeg 形式 + pingpong:BOOLEAN。デフォルト false + save_output:BOOLEAN。デフォルト true + 任意入力 audio:AUDIO、meta_batch:VHS_BatchManager、vae:VAE + 非表示の実行コンテキスト:PROMPT、EXTRA_PNGINFO、UNIQUE_ID → RETURN_TYPES:VHS_FILENAMES + RETURN_NAMES:Filenames + FUNCTION:combine_video + OUTPUT_NODE:trueComfyUI-VideoHelperSuite
参考用の入出力概要です。必須・任意の入力、初期値、バージョンは元の資料で確認してください。
この記事は役に立ちましたか?
匿名です。はい・いいえの件数のみ保存し、アカウント、IP アドレス、端末情報は保存しません。
出典と参考資料
2026-09-26 に、固定した Comfy Registry 1.7.9 アーカイブの SHA-256 と、現在の VHS ソース/README を再確認しました。静的インターフェースの根拠をリンクし、保存先、プレビュー、メタデータ、音声の確認を分けています。サイト上での動画/GPU テストは行っていません。
01VideoHelperSuite README(英語)出典の確認日: 2026-09-2602fp16 中間値での VHS 音声 dtype の報告(英語)出典の確認日: 2026-09-2603Comfy Registry 1.7.9 ソースアーカイブ:VHS_VideoCombine の静的インターフェース仕様(英語)出典の確認日: 2026-09-2604現在の VideoHelperSuite ノードソース(英語)出典の確認日: 2026-09-26問題を報告 · 624a6c35-1888-5cc6-bbe0-fa5728d9cc4c
関連記事
編集者がこのページに関連づけた記事です。
ログ内のキーワード: ffmpeg not found
見つからないものが FFmpeg 本体、入力ファイル、エンコーダーのどれかを特定します。ログに ffmpeg と表示されただけでは、動画関連一式を再インストールする理由にはなりません。
ログ内のキーワード: Unknown encoder
出力ファイルが作成されていても、再生できない、無音、または長さが正しくない場合があります。問題が生成、エンコード、保存、再生先のどこにあるかを確認します。
ログ内のキーワード: VHS_VideoCombine
このガイドは、fp16 中間データを使うケースについて報告された事例を扱い、無音のトラックすべてを対象とするものではありません。合成する前に、音声が存在し有効であることを確認します。