跳转至

ConcatenateVideos 多视频无缝拼接与自适应分辨率合并节点

节点核心功能 (What is it?)

ConcatenateVideos 节点允许创作者将多个独立的视频片段按先后顺序拼接为一个连贯的完整视频文件，并提供完备的封装格式、视频编码器及音频编码器配置选项。更重要的是，它具备智能自动分辨率适配机制：通过 FFprobe 检测所有视频尺寸，并以首个视频为基准，自动对后续不同尺寸的视频进行保等比缩放和黑边填充（Letterboxing / Pillarboxing），确保视频拼接过程中画面完全平滑连贯，杜绝画面拉伸畸变或视觉撕裂。

典型适用场景 (When would I use it?)

在以下情况下使用 ConcatenateVideos 节点：

  • 将多个分散的短视频片段拼装为长篇连贯影片；
  • 制作精彩镜头集锦（Montage）或高光时刻合集；
  • 将多个由 AI 视频生成模型（如 SVD、Runway、Luma、Kling 等）生成的数秒分段素材串联成完整故事情节；
  • 将先前被切分处理的视频片段重新封装合并；
  • 将物理分辨率不同（例如混杂了 720p、1080p、4K）的多个素材合并为一个统一规格的标准视频。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 ConcatenateVideos 节点。
  2. 将多路视频输入连入 video_inputs 参数插槽（支持接入离散的独立视频引脚或一个聚合的视频列表）。
  3. 配置目标输出格式（output_format）、视频编码器（video_codec）以及音频编码器（audio_codec）。
  4. 将合并完成的 output 引脚连接至下游视频展示或保存节点。

参数输入插槽 (Parameters)

  • video_inputs：待拼接合并的视频列表（接收 list[VideoArtifact] 或 list[VideoUrlArtifact]，至少需要接入 2 个视频）。
  • 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：转码编码画质与渲染速度平衡（fast / balanced / quality）。

输出引脚 (Outputs)

  • output：最终拼接整合完成的连续视频工件（VideoUrlArtifact）。
  • logs：详细的底层转码执行日志，实时呈现各视频尺寸检测、缩放及流拷贝详情。

智能分辨率自适应机制 (Automatic Video Resizing)

底层处理流水线

  1. 尺寸智能探测 (Dimension Detection)：节点调用 FFprobe 探测所有输入视频的物理像素宽高；
  2. 基准尺寸确立 (Reference Selection)：以排在第 1 位的视频尺寸作为全局目标基准规范；
  3. 高质量平滑重采样 (Smart Resizing)：对与基准尺寸不符的视频，底层自动应用高质量 Lanczos 算法进行缩放；
  4. 长宽比严格保真 (Aspect Ratio Preservation)：若原始长宽比与目标不同，自动在四周居中补齐纯黑边条（Padding），绝不进行强行拉伸挤压；
  5. 音轨免重编码保护：缩放调整画面时，原素材的音轨执行原生 Direct Stream Copy，最大化保障音质纯净。

执行日志范例 (Log Examples)

尺寸完全统一匹配时（极速）： 

✅ All videos have matching dimensions - no resizing needed

尺寸混杂需自适应缩放时： 

🔄 Videos have different dimensions - resizing to match first video...
Target dimensions (from first video): 1920x1080
• Video 1: 1920x1080 (reference)
• Video 2: 1280x720 → 1920x1080 (resizing...)
  ✅ Video 2 resized successfully
• Video 3: 1920x1080 (no resize needed)

格式与编码器选择专家建议 (Advanced Usage)

  • mp4 + libx264：跨平台兼容性最佳，网页与移动端播放首选方案；
  • mov + libx264 / ProRes：专业影视剪辑软件（FCPX、Premiere、DaVinci）后期制作推荐；
  • mkv + libx265：极致高压缩比，适合大容量归档；
  • webm + libvpx-vp9：极度适配现代 Web 网页在线无缝流播；
  • copy 模式（极速透传）：当所有接入的视频来源编码参数、分辨率及帧率完全相同时，将视频和音频编码器均设为 copy，节点将直接在容器层做极速数据包合并，耗时仅需数十毫秒。

常见问题与排查 (Common Issues)

  • 报错 "At least 2 videos required"：拼接节点必须至少接入两个有效视频输入才能执行合并。
  • 不同编码素材误用 copy 模式：若接入的素材来源于不同平台或编码器不同，选用 copy 会导致合并失败或画面绿屏花屏，此时请务必选择标准编码器（如 libx264 + aac）。
  • 目标分辨率非预期：记住首个视频决定全局分辨率。若希望整段视频输出为 4K，请务必将 4K 素材排在列表的首位。
  • Web 流媒体优化：输出的 MP4 文件底层已自动附带 faststart 标记（将 moov 原子前置），生成即可即点即播无需等待整段缓冲。