ComfyUI Node: MiniMax H3 Image • Reference Edit

MiniMax H3 Image • Reference Edit:

H3ReferenceEditPrepare is a sophisticated node designed for reference-guided image editing using the REF2VA method. This node allows you to incorporate up to nine ordered reference images to guide the editing process, providing a unique capability to maintain specific visual elements from the references while applying new edits. The node is particularly beneficial for artists looking to preserve certain aspects of the source image, such as style or color palette, while introducing new creative elements. It offers a high degree of control over the editing process by allowing adjustments to source fidelity, which influences how much of the original image's characteristics are retained. This node is essential for tasks that require a balance between maintaining the integrity of the original image and introducing new, creative modifications.

MiniMax H3 Image • Reference Edit Input Parameters:

clip

The clip parameter is used to tokenize and encode the prompt, which guides the editing process. It plays a crucial role in determining how the reference images and the source image are interpreted and combined during the editing process.

vae

The vae (Variational Autoencoder) is required for encoding the source and reference images. It is essential for transforming these images into a latent space where the editing operations are performed. Without a VAE, the node cannot process the images for editing.

source_image

The source_image is the primary image that you wish to edit. It serves as the base for the editing process, and its characteristics can be preserved or altered based on the reference images and other parameters.

edit_instruction

The edit_instruction is a textual prompt that describes the desired edits to be applied to the source image. This instruction guides the node in modifying the image according to your creative vision.

width

The width parameter specifies the width of the output image. It is important for defining the dimensions of the final edited image.

height

The height parameter specifies the height of the output image. Like the width, it determines the dimensions of the final edited image.

quality_profile

The quality_profile parameter allows you to select a preset that influences the quality of the output image. It can affect factors such as resolution and detail.

source_fidelity

The source_fidelity parameter controls how much of the original image's characteristics are preserved during the editing process. A higher value means more of the original image is retained.

source_fit

The source_fit parameter determines how the source image is resized to fit the specified dimensions. It affects the aspect ratio and composition of the final image.

optimize_for_still

The optimize_for_still parameter is a boolean that, when enabled, optimizes the prompt for still images, potentially improving the quality of static elements in the output.

reference_image_2 to reference_image_9

These parameters allow you to provide up to eight additional reference images. Each reference image can influence the editing process, helping to guide the style, color, or other visual elements of the final image.

MiniMax H3 Image • Reference Edit Output Parameters:

conditioning

The conditioning output is a complex data structure that contains the encoded information from the source and reference images, as well as the edit instructions. It is used to guide the image editing process and ensure that the final output aligns with the provided references and instructions.

MiniMax H3 Image • Reference Edit Usage Tips:

• Ensure that the source_image and vae are correctly set, as they are crucial for the node's operation.
• Use the edit_instruction to clearly articulate the desired changes, as this will guide the editing process.
• Adjust the source_fidelity to balance between preserving the original image and incorporating new elements from the references.
• Experiment with different quality_profile settings to achieve the desired level of detail and resolution in the output image.

MiniMax H3 Image • Reference Edit Common Errors and Solutions:

"Reference Edit mode requires source_image as <Picture 1>."

• Explanation: This error occurs when the source_image is not provided, which is essential for the reference edit mode.
• Solution: Ensure that you have connected a valid source image to the node.

"Reference Edit mode requires a VAE to encode the reference image(s)."

• Explanation: This error indicates that the VAE is missing, which is necessary for encoding the images.
• Solution: Connect a VAE to the node to enable the encoding of source and reference images.