動画の連結 (ConcatenateVideos)

概要 (What is it?)

ConcatenateVideos ノードは、複数の動画を連結して 1 本の連続したビデオファイルにまとめます。出力フォーマットやコーデック設定を柔軟にカスタマイズでき、異なる寸法の動画が入力された場合でも最初の動画の解像度に合わせて自動的にリサイズ・パディングを行うため、アスペクト比の破綻なくスムーズに結合できます。

使用する場面 (When would I use it?)

以下のような場面でこのノードを使用します：

複数のビデオクリップを 1 つの動画に繋ぎ合わせたい場合
異なるクリップからまとめ動画やモンタージュを作成したい場合
分割撮影された動画セグメントを結合したい場合
AI ビデオ生成モデルで生成された複数の短いクリップを繋げて長尺動画を作りたい場合
個別の動画ファイルからプレイリスト風のシーケンスを作成したい場合
解像度が異なる動画同士を自動リサイズ機能を用いて綺麗に統合したい場合

使い方 (How to use it)

基本セットアップ

ワークフローに ConcatenateVideos ノードを追加します
複数の動画をリストとして video_inputs パラメータに接続します（個別接続またはリスト接続）
必要に応じて出力フォーマットやコーデックを設定します
output を後続の表示・保存ノードに接続します

パラメータ一覧 (Parameters)

video_inputs: 連結する動画のリスト（VideoArtifact、VideoUrlArtifact、およびその両方のリストをサポート）
output_format: 出力ビデオ形式 - mp4, avi, mov, mkv, webm（デフォルト: mp4）
video_codec: 映像コーデック - libx264, libx265, libvpx-vp9, copy（デフォルト: libx264）
audio_codec: 音声コーデック - aac, mp3, libmp3lame, copy（デフォルト: aac）
output_frame_rate: 出力フレームレート制御
processing_speed: 処理速度と品質のトレードオフ

出力 (Outputs)

output: 連結されたビデオファイル（VideoUrlArtifact）
logs: ダウンロード、解像度チェック、リサイズ処理に関する詳細なログ

動画の自動リサイズ機能 (Automatic Video Resizing)

解像度が異なる動画が混在している場合、ノードはインテリジェントに自動リサイズを行います：

解像度の検出: FFprobe を使用してすべての入力動画の寸法を検査
基準動画の選定: リストの最初の動画の解像度が全体の目標寸法として設定されます
スマートリサイズ: 目標解像度と異なる動画は FFmpeg によって自動リサイズ
アスペクト比の維持: 元の縦横比を崩さないよう、必要に応じて黒帯（ピラーボックス/レターボックス）が追加されます
詳細ログ: リサイズ前後の寸法がログに記録されます

使用例 (Example)

AI 生成された複数のショートクリップを連結して 1 本の動画を作る例：

ConcatenateVideos ノードを追加します
複数の動画生成ノードの出力を video_inputs に接続します
幅広い互換性を確保するため output_format を "mp4"、video_codec を "libx264" に設定
高音質を保つため audio_codec を "aac" に設定
実行すると、すべてのクリップが順番に結合された 1 本の動画が生成されます

重要な注意点 (Important Notes)

最低入力数: 連結には最低 2 本以上の動画入力が必要です
基準解像度: リストの最初の動画（インデックス 0）の解像度が全体のターゲット解像度になります。最高品質のクリップを最初に接続することをお勧めします
同一フォーマット時の高速化: すべての入力動画のコーデックと寸法が同一の場合、copy を選択すると再エンコードなしで極めて高速に連結できます
Web 最適化: ブラウザでのストリーミング再生を高速化するため faststart フラグが自動付与されます

よくある問題 (Common Issues)

「At least 2 videos required」エラー: 2 本以上の動画が正しく接続されているか確認してください
フォーマットの不一致: コーデックや解像度が異なる動画を結合する場合は、コーデックを "copy" にせず "libx264" などを指定して再エンコードさせてください