動画のエクスポートに失敗する、または正しく再生できない：フレーム、エンコード、音声を分けて確認する

症状と対象範囲

出力ファイルが作成されていても、再生できない、無音、または長さが正しくない場合があります。問題が生成、エンコード、保存、再生先のどこにあるかを確認します。

検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。

Unknown encoder
Invalid argument
VideoCombine

出典から確認できること

VideoHelperSuite は、読み込み時のフレーム選択やフレームレートのほか、結合時の frame_rate、loop_count、pingpong、音声、format、保存オプションを文書化しています。ファイルの作成、ブラウザーでの再生、ワークフローメタデータの埋め込みはそれぞれ別の機能です。出典 1（英語） FFmpeg ではコーデックとコンテナーの対応状況を別々に説明しています。FFmpeg のコーデック（英語） FFmpeg のフォーマット（英語）

区別すべき状況

1. 入力フレームの選択や強制 FPS が、出力の結合に使うフレームレートと異なる。または loop_count／pingpong によって、表示されるフレーム数や順序が変わる。

2. コンテナー、エンコーダー、ピクセル形式が、この FFmpeg ビルドまたは再生環境でサポートされていない。

3. 音声が接続されていない、書き込みに失敗した、または高度なプレビューがまだトランスコード中である。

確認手順

以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。

手順 1. まず生成された画像フレームを確認し、モデル出力と動画エンコードを切り分けます。

手順 2. 実際のフレーム数、抽出設定、結合時の FPS、loop_count、pingpong を記録します。繰り返しのない順方向の 1 回再生では、フレーム数を出力 FPS で割ると基本的な長さの目安が得られます。その後、エンコードされたファイルと比較します。繰り返しや逆再生がある場合は、その目安も変わります。

手順 3. FFmpeg の stderr を保存し、文書化された形式でごく短いサンプルをエクスポートして、ファイルプレーヤーとブラウザーで別々にテストします。

手順 4. 音声入力、save_output、出力パス、メタデータ設定を確認します。一時的なプレビューを納品物と取り違えないでください。

完了の確認

再生先のプレーヤーでファイルが開き、解像度、フレーム数、長さ、音声が要件に合っていることを確認します。必要に応じてメタデータも別途確認します。

制限と注意点

コーデックやピクセル形式の変更は、互換性、品質、ファイルサイズに影響する場合があります。ここではハードウェアエンコードのベンチマークを示していません。

参照した原文資料

• VideoHelperSuite README（英語）（確認日：2026-09-25）
• FFmpeg コーデックのドキュメント（英語）（確認日：2026-09-25）
• FFmpeg フォーマットのドキュメント（英語）（確認日：2026-09-25）

出典の確認日：2026-09-25。GPU 実行、動画エンコード、再生テスト、必要最小限のメモリ測定は行っておらず、実行時の保証もありません。

関連するトラブルシューティング記事とガイド

• FFmpeg が見つからない：ComfyUI のプロセス環境で実行ファイルを確認する
• No space left on device：キャッシュ、一時ファイル、出力先のボリュームを確認する
• VideoHelperSuite リファレンス：フレーム読み込み、音声、合成、保存出力