ComfyUI Node: Load H3 RefMods

Load H3 RefMods:

The MiniMaxH3RefModsLoader node is designed to facilitate the loading of multiple reference modifications, or "RefMods," into the MiniMax H3 framework. This node allows you to load between one and eight RefMods, each with a specified strength, similar to the LoRA-style approach. The primary purpose of this node is to enable the integration of compressed reference images or videos into the MiniMax H3 model, enhancing its ability to process and attend to these references efficiently. By compressing reference media into a small number of tokens, the node significantly reduces computational overhead while maintaining the model's ability to utilize these references effectively. This makes it an essential tool for AI artists looking to incorporate complex reference data into their workflows without incurring high computational costs.

Load H3 RefMods Input Parameters:

mod_1, mod_2, ..., mod_8

These parameters represent the names of the reference modifications you wish to load. Each mod parameter corresponds to a slot where you can specify a RefMod by its name. If a name is provided that does not exist in the available mods, an error will be triggered. The default value is an empty string, indicating no mod is selected for that slot.

strength_1, strength_2, ..., strength_8

These parameters define the strength of each corresponding RefMod. The strength determines how much influence the RefMod will have when applied to the model. The value should be a float between 0.0 and 1.0, where 0.0 means no influence and 1.0 means full influence. The default value is 1.0, indicating full strength.

copies_1, copies_2, ..., copies_8

These parameters specify the number of times each RefMod should be loaded. This allows for repeated application of the same RefMod, effectively increasing its influence. The value should be an integer, with a default of 1, meaning the RefMod is loaded once.

Load H3 RefMods Output Parameters:

mods

This output parameter is a bundle of the loaded RefMods. It contains the actual reference modifications that have been loaded and are ready to be applied to the MiniMax H3 model. This bundle is essential for further processing and application within the model.

prompt_hint

The prompt_hint output provides a string that can be used as a hint or guide for the prompt. It is generated based on the loaded RefMods and their configurations, offering insights into how the loaded modifications might influence the model's output.

Load H3 RefMods Usage Tips:

• Ensure that all specified RefMod names exist in the available mods list to avoid errors. Running the Extract H3 RefMod node first can help populate this list.
• Adjust the strength parameters carefully to balance the influence of each RefMod. Experiment with different strengths to achieve the desired effect in your model's output.

Load H3 RefMods Common Errors and Solutions:

"RefMod slot X: 'name' not found in mods/. Run Extract H3 RefMod first."

• Explanation: This error occurs when a specified RefMod name does not exist in the available mods list.
• Solution: Verify that the RefMod name is correct and that it has been extracted and saved using the Extract H3 RefMod node.

"No rows selected (values 0 or both sides (none))"

• Explanation: This message indicates that no valid RefMods were selected for loading, possibly due to all strengths being set to zero or no names being provided.
• Solution: Ensure that at least one RefMod is selected with a non-zero strength to proceed with loading.