ComfyUI > Nodes > ComfyUI-SuperUltimateVaceTools > VACE Control Image Combine

ComfyUI Node: VACE Control Image Combine

Class Name

VACEControlImageCombine

Category
SuperUltimateVaceTools
Author
bbaudio (Account age: 164days)
Extension
ComfyUI-SuperUltimateVaceTools
Latest Updated
2025-10-31
Github Stars
0.13K

How to Install ComfyUI-SuperUltimateVaceTools

Install this extension via the ComfyUI Manager by searching for ComfyUI-SuperUltimateVaceTools
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-SuperUltimateVaceTools 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

VACE Control Image Combine Description

Facilitates combining control images for video processing, managing sequences with position and repetition control, supporting masked and unmasked images with custom masks for visual effects consistency.

VACE Control Image Combine:

The VACEControlImageCombine node is designed to facilitate the combination of control images for video processing tasks. This node is particularly useful in scenarios where you need to manage and manipulate sequences of images, such as in video editing or animation workflows. By allowing you to specify the position and repetition of control images within a sequence, it provides a flexible way to control the visual elements of a video over time. The node can handle both masked and unmasked images, and it supports the use of custom masks to refine the control over specific areas of the images. This capability is essential for creating complex visual effects and ensuring that the desired visual elements are consistently applied throughout the video sequence.

VACE Control Image Combine Input Parameters:

control_image

The control_image parameter is the primary image input for the node. It represents the image that will be used as a control element within the video sequence. This parameter is crucial as it defines the visual content that will be manipulated and combined with other images in the sequence.

frame_position

The frame_position parameter specifies the starting position of the control image within the video sequence. It is an integer value with a default of 0, and it can range from 0 to 65535. This parameter determines where in the sequence the control image will first appear, allowing you to precisely position visual elements within the video.

masked

The masked parameter is a boolean that indicates whether the control image should be used with a mask. By default, it is set to False. When set to True, the node will apply a mask to the control image, allowing for selective visibility of certain parts of the image. This is useful for creating effects where only specific areas of the image are visible or affected.

repeat

The repeat parameter defines how many times the control image should be repeated in the sequence. It is an integer with a default value of 1, and it can range from 1 to 65535. This parameter is useful for extending the duration of the control image's influence within the video, ensuring that it appears for the desired length of time.

custom_mask

The custom_mask parameter is an optional input that allows you to provide a specific mask to be applied to the control image. This mask can be used to refine the areas of the image that are visible or affected, providing additional control over the visual output.

previous_control

The previous_control parameter is an optional input that allows you to include a list of previously defined control images. This enables the combination of multiple control images into a single sequence, facilitating complex video editing tasks where multiple visual elements need to be managed simultaneously.

VACE Control Image Combine Output Parameters:

vace_control_list

The vace_control_list is the output parameter of the node. It is a list that contains the combined control images along with their associated metadata, such as frame positions and repeat counts. This output is essential for further processing in video workflows, as it provides a structured representation of the control images and their sequence within the video.

VACE Control Image Combine Usage Tips:

  • To achieve smooth transitions between control images, carefully adjust the frame_position and repeat parameters to ensure that images are positioned and repeated as needed within the sequence.
  • Utilize the custom_mask parameter to apply specific masks to control images, allowing for precise control over which parts of the image are visible or affected in the video.

VACE Control Image Combine Common Errors and Solutions:

"控制帧长度超过生成长度\nLength of control image exceeds length of generation"

  • Explanation: This error occurs when the total length of the control images exceeds the length of the video sequence being generated.
  • Solution: Ensure that the combined length of all control images, as specified by the frame_position and repeat parameters, does not exceed the total length of the video sequence. Adjust these parameters accordingly to fit within the sequence length.

VACE Control Image Combine Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-SuperUltimateVaceTools
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.