Nodes/comfyui-minimax-h3-audio-T8/MiniMax H3 Turbo / SLA Profile Router (Advanced EXP)
ComfyUI Node

MiniMax H3 Turbo / SLA Profile Router (Advanced EXP)

The router that refuses to let one pretend to be the other

By T8mars·Created about a month ago·Updated a day ago· 1,031
MiniMax H3 Turbo / SLA Profile Router (Advanced EXP)
  • model
  • sigmas
  • model
  • runtime
  • report_json
turbo_lora_nameminimax_h3_fl2v_turbo_4step_v0.1_comfyui_alpha8-T8-convert.safetensors
sla_lora_nameminimax_h3_fl2v_turbo_4step_v0.1_768p_sla_comfyui_bf16.safetensors
profileconsumer_turbo8_recommended
base_policyauto_detect_exp
max_router_workspace_mib512
sla_start_percent0.15
sla_end_percent0.90

H3 has two different speed paths floating around the community, and they are not interchangeable: the consumer 8-step Turbo LoRA and the LightX2V SLA sparse-attention experiment. The Turbo/SLA Profile Router exists to keep them from getting mushed together - because running an SLA LoRA as a dense Turbo fallback is exactly the kind of mistake that produces a "collapsed" video that looks like the model broke. Its whole personality is fail-closed: mismatched sigmas refuse before sampling, and an SLA file is never silently treated as a Turbo.

How it works

You feed it the Dual-Clock MODEL (optionally through the complete KJNodes MiniMax H3 Sage patch - do not attach an external LoRA) and the SIGMAS from the same Dual-Clock node. Then the profile Combo picks a lane:

  • consumer_turbo8_recommended - loads the corrected Alpha8 bypass Turbo LoRA, requires 8 NFE with video/audio shift 12/3, dense or authenticated KJ Sage attention. This is the validated, project-blessed route.
  • sla_4step_upstream_exact_exp - loads the LightX2V SLA LoRA at the published 4 NFE, shift 6/3, 85% sparse. This replicates the upstream experiment's exact contract; it is not a quality preset.
  • sla_4step_int8_bypass_exp - the research lane: 4/6/3 with the INT8 ConvRot base left untouched and the SLA residual applied dynamically. Explicitly not validated.
  • disabled_identity - no LoRA, no attention change. Handy as an A/B control.

The turbo_lora_name and sla_lora_name Combos are the two files it can load, and base_policy (default auto_detect_exp) records whether your base resembles the published BF16/FP8 evidence - reporting mismatches without blocking, so you stay informed while the node stays permissive about which base actually runs.

Outputs: model, a runtime object (H3_T8_LIGHTX2V_SLA_RUNTIME) that carries the SLA state for downstream consumers, and report_json saying exactly which lane ran and how many forwards happened.

Why the strictness matters

The tooltips are unusually explicit about the failure mode: a sigmas mismatch "fails before sampling instead of producing a misleading collapsed video." The author's verification report documents the exact incident - an 8-NFE rerun that the SLA path rejected after ~1 second, which his own runtime report proved was zero SLA calls and incompatible FL2VA anchors, not an SLA kernel failure. That's the kind of archaeology this node is designed to spare you. It will never quietly run an SLA LoRA through dense attention and call it "close enough."

Installing it

Standard pack install - ComfyUI Manager search "MiniMax H3 Audio T8", or:

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/comfyui-minimax-h3-audio-T8.git minimax-h3-audio-T8

Update ComfyUI core first, restart. The LoRAs themselves go in ComfyUI/models/loras - the Turbo file is the ..._alpha8-T8-convert.safetensors and the SLA file is the ..._768p_sla_comfyui_bf16.safetensors. The max_router_workspace_mib (default 512) is an SLA-only fail-closed workspace ceiling, not a whole-workflow VRAM limit, and sla_start_percent/sla_end_percent only matter for the INT8 bypass lane (0.15–0.90 maps to dense/sparse/sparse/sparse across four forwards).

Where people get burned

Three things. The Alpha8 Turbo file must be the corrected convert - the pack shipped a fix because the original Alpha8 reference had issues, so don't keep an old copy around. Second, the SLA "infer_steps=5" confusion: LightX2V's published infer_steps=5 means five sigma grid points, which is four model evaluations, which is the 4 NFE this node demands - don't "help" by raising NFE. And third, the released SLA evidence is BF16/FP8-family only; if you're on the INT8 ConvRot base, the exact profile reports it rather than pretending to be upstream parity. That honesty is a feature.

CategoryT8/MiniMax H3/Performance/Experimental

Inputs (9)

NameTypeDefaultDescription
modelMODELConnect the Dual-Clock MODEL, optionally through the complete KJNodes MiniMax H3 Sage patch. Do not connect an external LoRA.
sigmasSIGMASConnect SIGMAS from the same Dual-Clock node. Consumer Turbo8 requires 8/12/3; SLA exact requires 4/6/3. A mismatch fails before sampling instead of producing a misleading collapsed video.
turbo_lora_nameCOMBOminimax_h3_fl2v_turbo_4step_v0.1_comfyui_alpha8-T8-convert.safetensorsRegular Turbo LoRA for the recommended 8-step route. File identity, metadata and structure are reported only and never block loading.
sla_lora_nameCOMBOminimax_h3_fl2v_turbo_4step_v0.1_768p_sla_comfyui_bf16.safetensorsLightX2V SLA LoRA used only by the upstream-exact SLA profile. Alternate files are passed to the real loader without an identity gate.
profileCOMBOconsumer_turbo8_recommendedconsumer_turbo8_recommended: corrected regular Turbo LoRA, 8/12/3, dense or authenticated KJ Sage attention. sla_4step_upstream_exact_exp: SLA LoRA, 4/6/3, exact released 85% sparse experiment; base-family matching is diagnostic only. sla_4step_int8_bypass_exp: 4/6/3 INT8 ConvRot research route using dynamic model-only LoRA bypass to avoid base re-quantization. disabled_identity: no LoRA or attention change.
base_policyCOMBOauto_detect_expRecords whether the base resembles the published BF16/FP8 evidence. Unknown, quantized and INT8 bases still pass through to real execution.
max_router_workspace_mibINT51232–2048Fail-closed SLA router workspace ceiling. It affects only the SLA profile and is not a whole-workflow VRAM limit.
sla_start_percentFLOAT0.150–1INT8 bypass only: begin SLA sparse attention at this ComfyUI denoising progress. Default 0.15 keeps the first 4-step model forward dense. Other profiles ignore this range.
sla_end_percentFLOAT0.900–1INT8 bypass only: stop SLA sparse attention after this denoising progress. With 4 NFE, 0.15-0.90 maps to dense/sparse/sparse/sparse because model calls begin at 0%, 25%, 50% and 75%.

Outputs (3)

NameTypeDescription
modelMODEL
runtimeH3_T8_LIGHTX2V_SLA_RUNTIME
report_jsonSTRING