ImageUpscaleWithModelBatched Node Documentation

Overview

The ImageUpscaleWithModelBatched node is a specialized component in the ComfyUI framework designed to upscale batched images using a specified upscale model. This node is particularly useful when handling large image batches and requires managing VRAM usage efficiently. It provides an additional feature to set sub-batches, which is beneficial in reducing VRAM consumption during the upscaling process.

Inputs

The node accepts the following inputs:

1. upscale_model:

   • Type: UPSCALE_MODEL
   • Description: The model to be used for upscaling images. This model is responsible for enhancing the quality and resolution of the input images.

2. images:

   • Type: IMAGE
   • Description: A batch of images that you want to upscale. The images should be provided in a format supported by the upscale model.

3. per_batch:

   • Type: INT
   • Default: 16
   • Range: 1 to 4096
   • Description: Specifies the number of images to process in one sub-batch. This parameter helps manage VRAM usage by controlling how many images are simultaneously passed through the upscale model.

Outputs

The node produces the following output:

• IMAGE: The upscaled batch of images. Each image in the batch is enhanced according to the specified upscale model, leading to improved quality and higher resolution.

Usage in ComfyUI Workflows

The ImageUpscaleWithModelBatched node is typically used in workflows where there is a need to upscale multiple images efficiently. It is particularly beneficial in scenarios where limited VRAM is a concern, as it allows the user to process images in smaller sub-batches.

Example Workflow

1. Image Collection: Gather a batch of images that require upscaling.
2. Model Selection: Choose an appropriate upscale model that matches the use case (e.g., super-resolution, detail enhancement).
3. Node Configuration: Set up the ImageUpscaleWithModelBatched node by selecting the upscale model, providing the batch of images, and defining the per_batch parameter based on VRAM constraints.
4. Execution: Connect the node within the ComfyUI workflow and execute the upscale process.
5. Result Handling: The output images can be further processed or saved as needed.

Special Features and Considerations

• VRAM Management: The per_batch parameter is a defining feature of this node, enabling efficient VRAM usage by controlling the number of images processed concurrently.
• Flexibility in Model Choice: Users have the freedom to choose from a variety of upscale models, depending on their specific needs and desired output quality.
• Seamless Integration: As part of ComfyUI, this node integrates smoothly with other nodes and workflows, providing a modular approach to image processing.

This node is an excellent tool for users who need to perform high-quality upscaling of images with considerations for VRAM efficiency, making it ideal for both individual projects and larger automation pipelines.