Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-CustomNodeKit > 视频网格拼接

ComfyUI Node: 视频网格拼接

Class Name

VideoGridCompose

Category
video
Author
user2318 (Account age: 2574days)
Extension
ComfyUI-CustomNodeKit
Latest Updated
2026-07-16
Github Stars
0.05K

How to Install ComfyUI-CustomNodeKit

Install this extension via the ComfyUI Manager by searching for ComfyUI-CustomNodeKit
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-CustomNodeKit in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

视频网格拼接 Description

Merge up to four video streams into a single grid with customizable layouts and audio selection, streamlining video composition.

视频网格拼接:

VideoGridCompose is a versatile node designed to seamlessly merge up to four video streams into a single cohesive video grid. This node offers a variety of layout options, including horizontal, vertical, 2x2 grid, left-right, and top-bottom arrangements, allowing you to customize the visual presentation of your videos. One of its standout features is the ability to process videos in a streaming manner without the need for frame extraction, making it efficient and time-saving. Additionally, VideoGridCompose provides options for audio selection, enabling you to choose which video's audio track to include in the final output. This node is particularly beneficial for creating video collages or presentations where multiple video sources need to be displayed simultaneously in a structured format.

视频网格拼接 Input Parameters:

video_paths

This parameter accepts a multiline string input where each line represents the path to a video file. You can specify up to four video paths, and the node will automatically remove duplicates and empty lines. This input is crucial as it determines the video sources that will be combined into the grid. There are no explicit minimum or maximum values, but the node supports a maximum of four video paths.

layout

The layout parameter allows you to choose the arrangement of the video grid. Options include "水平排列" (horizontal), "垂直排列" (vertical), "田字格2×2" (2x2 grid), "左一右N" (left-right), and "上一+下N" (top-bottom). The default layout is "水平排列" (horizontal). This parameter significantly impacts the visual structure of the final video, enabling you to tailor the presentation to your specific needs.

audio_source

This parameter lets you select which video's audio track to include in the final output. Options are "无音频" (no audio), "视频1" (video 1), "视频2" (video 2), "视频3" (video 3), and "视频4" (video 4). The default is "无音频" (no audio). Choosing the right audio source is essential for ensuring that the final video conveys the desired auditory experience.

output_path_prefix

This parameter specifies the prefix for the output file path relative to the ComfyUI output directory. The default value is "video/grid_output". This input is important for organizing and locating the generated video file, especially when working with multiple projects or outputs.

视频网格拼接 Output Parameters:

video_path

The output parameter video_path returns the file path of the composed video grid as a string. This path is where the final video is saved, and it is essential for accessing and utilizing the generated video. The output path is determined by the output_path_prefix input parameter, ensuring that you can easily locate the video within your specified directory structure.

视频网格拼接 Usage Tips:

  • To achieve the best visual results, ensure that the videos you are combining have similar resolutions and aspect ratios, as this will prevent distortion or unexpected layout issues.
  • When selecting the audio source, consider the content of each video to ensure that the chosen audio complements the visual presentation effectively.
  • Utilize the layout options to create dynamic and engaging video presentations, experimenting with different arrangements to find the most visually appealing configuration for your content.

视频网格拼接 Common Errors and Solutions:

RuntimeError: Invalid video path

  • Explanation: This error occurs when one or more of the specified video paths are incorrect or the files do not exist.
  • Solution: Double-check the video paths provided in the video_paths input to ensure they are correct and that the files are accessible.

RuntimeError: Unsupported layout option

  • Explanation: This error is triggered when an invalid layout option is selected.
  • Solution: Verify that the layout option chosen is one of the supported options: "水平排列", "垂直排列", "田字格2×2", "左一右N", or "上一+下N".

RuntimeError: Audio source not available

  • Explanation: This error occurs when the selected audio source does not exist or is not available in the provided videos.
  • Solution: Ensure that the video corresponding to the selected audio source is included in the video_paths input and contains an audio track.

视频网格拼接 Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-CustomNodeKit
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

视频网格拼接