ComfyUI Node: Qwen Image 2.1 Reference Strength

Qwen Image 2.1 Reference Strength:

QwenImage21ReferenceStrength is a node designed to enhance the editing capabilities of the Qwen Image 2.1 model by allowing you to control the attention weight of a selected reference image during the editing process. This node is particularly useful for AI artists who want to fine-tune the influence of reference images on the final output. By adjusting the attention weight, you can either amplify or diminish the impact of a reference image, providing greater flexibility and precision in image editing. The node ensures that changes to the attention scores are made while preserving normalized attention, image values, and native prefix caching, allowing for seamless integration into your workflow without disrupting the underlying model's functionality.

Qwen Image 2.1 Reference Strength Input Parameters:

model

This parameter represents the model to which the reference strength adjustments will be applied. It is crucial that the model is compatible with the Qwen Image 2.1 framework, as the node is specifically designed to work with this model version.

reference_index

The reference_index parameter specifies the order of the reference image in the encoder's input sequence, starting from 1. This index determines which reference image's attention weight will be adjusted. The minimum value is 1, and the maximum is 16, with a default value of 1. This allows you to target specific reference images for attention modification.

strength

The strength parameter controls the attention weight applied to the selected reference image. A value of 1 represents the native attention level, values above 1 increase the reference's influence, and values below 1 decrease it. Setting the strength to 0 blocks direct attention to the reference's latent tokens, although reference information already present in text remains unaffected. The minimum value is 0.0, the maximum is 8.0, and the default is 1.2. Adjusting this parameter allows for nuanced control over the reference image's impact on the final output.

Qwen Image 2.1 Reference Strength Output Parameters:

model

The output is a modified version of the input model, with the specified reference strength adjustments applied. This output model retains all the original functionalities of the Qwen Image 2.1 model while incorporating the customized attention weights, enabling you to achieve the desired artistic effects in your image editing tasks.

Qwen Image 2.1 Reference Strength Usage Tips:

• To enhance the influence of a particular reference image, increase the strength parameter above 1. This will make the reference image more prominent in the final output.
• If you want to minimize the impact of a reference image, reduce the strength parameter below 1. This can be useful when you want the reference to have a subtle effect or when focusing on other elements in the composition.

Qwen Image 2.1 Reference Strength Common Errors and Solutions:

"Reference Strength requires the native Qwen Image 2.1 model."

• Explanation: This error occurs when the model provided is not compatible with the Qwen Image 2.1 framework.
• Solution: Ensure that the model you are using is the Qwen Image 2.1 model. Check the model's compatibility before applying the node.

"Reference indices start at 1."

• Explanation: This error indicates that the reference_index parameter is set to a value less than 1. - Solution: Adjust the reference_index to be 1 or higher, as reference indices are 1-based.

"Reference strength must be finite and nonnegative."

• Explanation: This error is raised when the strength parameter is set to a negative or non-finite value.
• Solution: Ensure that the strength parameter is a finite, nonnegative number. Adjust the value to be within the valid range specified.