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 > NKD Klein Tools > 😺NKD Klein Reference Control

ComfyUI Node: 😺NKD Klein Reference Control

Class Name

NKDKleinReferenceControl

Category
😺NKD Nodes/Klein
Author
nekodificador (Account age: 2573days)
Extension
NKD Klein Tools
Latest Updated
2026-06-17
Github Stars
0.06K

How to Install NKD Klein Tools

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

😺NKD Klein Reference Control Description

Adjust reference image influence strength with per-step curve control and regional confinement for precise composition adjustments.

😺NKD Klein Reference Control:

The NKDKleinReferenceControl node is an experimental tool designed to provide full control over a single reference image within a creative AI workflow. Its primary function is to adjust the strength of a reference image's influence on the final output, with the option to apply a per-step curve for dynamic control throughout the denoising process. Additionally, by connecting a mask, you can confine the reference's influence to a specific area on the canvas, allowing for precise regional control. This node is particularly useful for artists who want to fine-tune the impact of reference images, ensuring that each image contributes to the composition as desired. By chaining multiple nodes, you can manage several references independently, making it a versatile tool for complex projects.

😺NKD Klein Reference Control Input Parameters:

reference_index

This parameter specifies which reference image the node will control. It is an integer value where 0 corresponds to the main reference (ref_0), 1 to ref_1, and so on, up to a maximum of 7. The default value is 1. By selecting the appropriate index, you can target the specific reference image you wish to adjust, allowing for precise control over its influence in the composition.

schedule

The schedule parameter is an optional input that allows you to apply a per-step curve to the reference image's strength. This curve should be a float value between 0 and 1, such as the output from an NKD Sigmas Curve. When connected, it multiplies the reference's strength across denoise steps, enabling dynamic adjustments throughout the process. If left unconnected, the reference strength remains constant.

weight

This parameter controls the overall strength of the reference image. It is a float value where 1.0 indicates no change, values below 1.0 dilute the reference (with 0 effectively removing it), and values above 1.0 reinforce it, up to a maximum of 2.0. A connected curve can further modulate this strength per step, providing additional flexibility in how the reference image influences the final output.

mask

The mask parameter is an optional input that allows you to confine the reference image's influence to a specific zone on the canvas. By connecting a mask, you activate regional control, ensuring that the reference image only affects the designated area. If left unconnected, the node functions purely as a strength control without regional limitations.

latent

This optional input allows you to pass through latent data, which can be chained into subsequent Reference Control nodes. This facilitates the management of multiple references, ensuring that each one is processed in sequence and maintains its intended influence throughout the workflow.

😺NKD Klein Reference Control Output Parameters:

latent

The latent output parameter passes through the latent data, which can be used to drive several references in a chain. This output is crucial for maintaining the continuity of reference control across multiple nodes, ensuring that each reference image's adjustments are preserved and applied consistently throughout the creative process.

😺NKD Klein Reference Control Usage Tips:

  • To achieve precise control over a reference image's influence, adjust the weight parameter according to your desired level of impact, using values above 1.0 to strengthen and below 1.0 to weaken the reference.
  • Utilize the schedule parameter to apply dynamic changes to the reference's strength throughout the denoising process, allowing for more nuanced and responsive adjustments.
  • When working with multiple reference images, chain several NKDKleinReferenceControl nodes, each targeting a specific reference index, to manage their influences independently.
  • Use the mask parameter to confine a reference image's effect to a specific area on the canvas, enabling targeted adjustments and enhancing the composition's overall balance.

😺NKD Klein Reference Control Common Errors and Solutions:

Reference Index Out of Range

  • Explanation: This error occurs when the reference_index parameter is set to a value outside the allowable range (0 to 7).
  • Solution: Ensure that the reference_index is set within the valid range, corresponding to the available reference images in your project.

Invalid Schedule Curve

  • Explanation: This error arises when the schedule parameter is connected to an invalid or improperly formatted curve.
  • Solution: Verify that the schedule input is connected to a valid float curve output, such as from an NKD Sigmas Curve, and ensure it provides values between 0 and 1.

Weight Value Out of Bounds

  • Explanation: This error occurs when the weight parameter is set to a value outside the permissible range (0 to 2).
  • Solution: Adjust the weight parameter to fall within the valid range, ensuring it accurately reflects the desired strength adjustment for the reference image.

😺NKD Klein Reference Control Related Nodes

Go back to the extension to check out more related nodes.
NKD Klein Tools
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.

😺NKD Klein Reference Control