Nodes/RunningHub MiniMax H3/RunningHub MiniMax H3 FL2VA Model Loader (Direct) (Legacy)
ComfyUI Node

RunningHub MiniMax H3 FL2VA Model Loader (Direct) (Legacy)

Pick This When You Know You're Doing Keyframes

By RH-RunningHub·Created 29 days ago·Updated 18 days ago· 1
RunningHub MiniMax H3 FL2VA Model Loader (Direct) (Legacy)
    • h3_model
    model_root
    dtypeauto
    transformer_pathMiniMax-H3-FL2VA-int8_convrot.safetensors
    attention_backendauto

    MiniMax H3 comes in two DiT flavors: FL2VA, the first/last-frame keyframe model, and Ref2VA, the multimodal-reference model. This legacy loader is the FL2VA half, hard-wired so it always parses the FL2VA partition of the weights. It's a legacy node - the pack now steers you to the single RHMiniMaxH3ModelLoader that handles both - but if your workflow was built on the older granular set, this is the loader sitting in it, and it still does exactly the right job.

    "FL2VA" is worth unpacking once, because it explains why you'd reach for this node at all. It's H3's image/keyframe-to-video path: you give it a first frame (or a first and last frame), and the model fills in a video between them - motion, audio and all. H3's trick is that it's omni-modal, so even a keyframe-to-video run generates its native stereo sound together with the picture, not as a separate audio pass. That's the capability people came for at launch, and it's the one this loader gates.

    Inputs

    Same direct-loader contract as its sibling, but pinned to one partition:

    • model_root - the weights root (models/MiniMax-H3-INT8-CONVROT, with the old models/MiniMax-H3 layout still accepted).
    • dtype - auto, bfloat16, or float16; auto/bfloat16 recommended, with H3's fp32 layers preserved.
    • transformer_path - explicit DiT file, defaulting to MiniMax-H3-FL2VA-int8_convrot.safetensors. No auto-swapping between quantized and BF16 here - say what you mean.

    The optional attention_backend (auto / sdpa / sage / ck) is the one knob worth touching. ck is Comfy Kitchen's INT8 attention, the same kernel as --use-ck-attention; sage needs SageAttention installed. Both can be meaningful speed wins on a 33B model.

    Output: a single h3_model handle for the sampler.

    The honest take

    This node exists for backward compatibility. It's correct, it's explicit, and there's nothing wrong with it - but the only real difference between this and RHMiniMaxH3Ref2VAModelLoader is which partition name it defaults to and which directory it prefers to resolve. The modern loader figures the partition out from the filename you pick and adds LoRA support, which this one can't. New workflow? Use the modern loader. Old workflow you need to keep working? This one runs fine.

    Install and models

    cd ComfyUI/custom_nodes
    git clone https://github.com/RH-RunningHub/ComfyUI-RH-MiniMax-H3.git
    pip install -r ComfyUI-RH-MiniMax-H3/requirements.txt
    

    Restart, then get the ~95 GiB INT8 ConvRot bundle into ComfyUI/models/MiniMax-H3-INT8-CONVROT/ (hf download Gluttony10/MiniMax-H3-INT8-CONVROT --local-dir ./models/MiniMax-H3-INT8-CONVROT, or ModelScope in China). The pack needs ComfyUI 0.27+ and a CUDA PyTorch build. And the standing reminder: the MiniMax H3 Community License excludes the US, EU, UK and South Korea from running the local weights - that's a weights issue, not a node issue, but it's yours to navigate.

    CategoryRunningHub/MiniMax H3/loaders

    Inputs (4)

    NameTypeDefaultDescription
    model_rootCOMBO选择 MiniMax-H3 权重根目录:专属根 models/MiniMax-H3-INT8-CONVROT(兼容 models/MiniMax-H3)(<类型>/<分区>/<模型>,放量化与合并产物),或 models/diffusers 下的官方 release 根(含 FL2VA/Ref2VA 分片子目录);该节点固定解析 FL2VA 分区。三个组件必须来自同一个根。
    dtypeCOMBOautoauto/bfloat16 推荐;runtime 保留 H3 指定的 fp32 层。
    transformer_pathCOMBOMiniMax-H3-FL2VA-int8_convrot.safetensors必须明确选择DiT模型名(权重文件名或逻辑名);不会再自动切换量化/BF16 权重。
    attention_backendoptCOMBOautoauto=服从 ComfyUI;sdpa=PyTorch;sage=SageAttention;ck=Comfy Kitchen INT8(同 --use-ck-attention)

    Outputs (1)

    NameTypeDescription
    h3_modelMINIMAX_H3_DIRECT_MODEL