MiniMax H3 CLIP Projection Patcher:
This node prepares a Qwen3-VL 4B or 8B encoder for MiniMax H3 by applying a projection into H3’s 32B conditioning space. The projection helps make the encoder’s conditioning compatible with the space MiniMax H3 expects. It is a model-compatibility step, not an image enhancement or generation setting.
MiniMax H3 CLIP Projection Patcher Input Parameters:
clip
The required CLIP object containing the encoder you want to patch. Use a Qwen3-VL 4B or 8B encoder, as specified by the node’s description. The node applies the selected projection to this object and returns a CLIP object for subsequent workflow steps. No minimum, maximum, or default value is specified.
projection
The required selection of the projection to apply. Its choices come from the projection files detected by the node; the available option names are not specified in the provided source. Select a .safetensors projection that matches your encoder’s 4B or 8B size. The node’s tooltip directs you to place the file in ComfyUI/models/clip_projections. No numeric minimum or maximum applies, and no default selection is specified.
MiniMax H3 CLIP Projection Patcher Output Parameters:
clip
The CLIP object returned after the selected MiniMax H3 projection has been applied to the supplied encoder. Connect this output to the next workflow step that needs the projected encoder. It is not a generated image or conditioning value; it is the encoder object prepared for use with MiniMax H3’s conditioning space.
MiniMax H3 CLIP Projection Patcher Usage Tips:
- Match the projection to the encoder size: use a 4B projection with a Qwen3-VL 4B encoder, or an 8B projection with a Qwen3-VL 8B encoder.
- Put the matching
.safetensorsprojection inComfyUI/models/clip_projections. If the selection list is empty, consult the project’sREADME.mdfor model links and loader settings, as the node tooltip advises. - Keep the returned
clipconnected to downstream steps that should use the projected encoder; connecting the original encoder instead bypasses this node’s result.
MiniMax H3 CLIP Projection Patcher Common Errors and Solutions:
No projection options appear in the projection menu
- Explanation: The node builds this menu from available projections. Its tooltip specifically addresses the case where none are listed.
- Solution: Download a matching 4B or 8B
.safetensorsprojection intoComfyUI/models/clip_projectionsand check the project’sREADME.mdfor model links and loader settings.
Missing required input: clip or projection
- Explanation: Both inputs are required by the node interface, so the node cannot run without an encoder and a projection selection. The exact validation message depends on ComfyUI.
- Solution: Connect a suitable encoder to
clipand select an available item forprojection.
The selected projection does not match the encoder
- Explanation: The node’s tooltip calls for a projection matching the encoder’s 4B or 8B size. A mismatch may prevent the projection from being applied correctly; the provided source does not specify the resulting error text.
- Solution: Confirm whether your Qwen3-VL encoder is 4B or 8B, then select the corresponding projection file.
Projection file cannot be loaded
- Explanation: A run may fail if the selected projection file is missing or unusable. The provided node class does not specify an exact file-loading error message.
- Solution: Check that the selected
.safetensorsfile is present inComfyUI/models/clip_projectionsand follow the project’sREADME.mdfor the correct download and loader settings.
