Nodes/MiniMax H3 RefDelta Solver/[Advanced/Diagnostic] MiniMax H3 RefDelta Sampler
ComfyUI Node

[Advanced/Diagnostic] MiniMax H3 RefDelta Sampler

The original RefDelta sampler, now wearing a lab coat

By xmarre·Created 4 days ago·Updated 2 days ago· 1
[Advanced/Diagnostic] MiniMax H3 RefDelta Sampler
    • sampler
    adaptive_ordertrue
    risk_sensitivity1.00
    stochastic_adaptation_strength0.50
    minimum_stochastic_multiplier0.25
    trajectory_correctionfalse
    video_correction_strength0.15
    audio_correction_strength0.05
    correction_bound0.50
    endpoint_fidelity_fraction0.15
    s_noise1.00
    max_stage3
    debug_telemetryfalse
    telemetry_prefixrefdelta_trajectory
    calibration_capturefalse
    calibration_idrefdelta_calibration
    stochastic_control_modelegacy_global
    video_stochastic_strength_scale1.00
    audio_stochastic_strength_scale1.00
    static_video_stochastic_adaptation_strength0.50
    video_stability_restore_strength1.00
    video_stability_motion_low0.020
    video_stability_motion_high0.100
    video_stability_diffusion_low0.020
    video_stability_diffusion_high0.150
    video_stability_diffusion_weight0.50
    video_stability_normalization_floor0.10
    video_stability_gamma1.00
    video_stability_spatial_radius2
    video_stability_temporal_radius2
    video_stability_ema0.70
    video_stability_start_fraction0.10
    video_stability_full_fraction0.30
    stochastic_gate_slew_limit0.00
    debug_stability_mapsfalse

    What this is

    This is the original MiniMax H3 RefDelta sampler, the one the pack shipped before the streamlined production node existed. Today the display name says it plainly: [Advanced/Diagnostic]. It's the same ER-SDE sampler machinery underneath, but with every knob exposed - including the diagnostic capture controls and the controller-mode switch that the production node deliberately hides.

    So the honest framing: for normal generation, use MiniMax H3 RefDelta Stability Sampler. Reach for this one when you're doing A/B experiments, manual controller tuning, or running the diagnostic capture that feeds the Comparison Replay workflow.

    Why it still exists

    Saved workflows. When v0.3.0 shipped the production preset, the author had a choice: silently change the default behavior of every old workflow, or keep the original node ID and its released defaults intact. They kept the old defaults. That means this node's minimum_stochastic_multiplier defaults to 0.25 and trajectory_correction to false - the older, less-tuned values - on purpose. Don't read those as the recommended settings. They're the compatibility settings.

    The extra knobs you get here

    The full production control set is present (stability map thresholds, gamma, EMA, radii, correction strengths, and so on), plus two things the production node removes:

    • stochastic_control_mode - pick legacy_global (the released packed-scalar behavior, the default), streamwise, or spatiotemporal_stability (the controller the production node uses). This is how you A/B the controller itself.
    • calibration_capture + calibration_id - disk-backed diagnostic capture. Turn this on and the sampler writes exact packed states, x0 values, sigmas, actual/forecast classification and telemetry under ComfyUI/output/refdelta_calibration/<calibration_id>/. This is Pass 1 of the three-pass comparison workflow.

    The rest - adaptive_order, risk_sensitivity, stochastic_adaptation_strength, s_noise, max_stage, debug_telemetry, debug_stability_maps - matches the production node's inputs.

    The strict stock baseline

    This is the neat trick: with everything disabled, it delegates straight to ComfyUI's native sample_er_sde, so it doubles as a clean ER-SDE reference. For a strict stock baseline set:

    adaptive_order = false
    stochastic_adaptation_strength = 0
    trajectory_correction = false
    debug_telemetry = false
    calibration_capture = false
    

    That path is byte-for-byte stock ER-SDE, no instrumentation, no adaptation. Useful when you want to know whether any difference in output is the controller or the sampler family itself.

    Wiring and install

    Output is a single SAMPLER; plug it into the sampler socket of a KSampler or SamplerCustomAdvanced. Install is the shared pack path:

    cd ComfyUI/custom_nodes
    git clone https://github.com/xmarre/ComfyUI-MiniMax-H3-RefDelta-Solver.git
    

    Restart ComfyUI. No pip dependencies (the pack's pyproject.toml lists none), though you do need the fused checkpoint from HuggingFace (xmarre/MiniMax-H3-Pruned-Ref-Delta-Fused-r1024-ComfyUI) - a full H3 model, not a LoRA - and the usual BasicScheduler with beta for scheduling.

    Common issues

    • You're probably on the wrong node. If you just want to generate, the Production/Stability Sampler is the validated path. This node's defaults are deliberately older. Same-seed testing shows the two are behaviorally identical when configured with the same values, so it's UX and defaults, not secret sauce.
    • Capture writes disk files. Leaving calibration_capture on during normal generation dumps a calibration dir every run. It's cheap, but it clutters ComfyUI/output/ and you'll forget it's on. Switch it off unless you're building a comparison pass.
    • The license reminder. The MiniMax-H3 weights this targets are territory-restricted (US, EU, UK, South Korea excluded) under the H3 Community License - worth checking before you plan a workflow around them.
    Categorysampling/custom_sampling/samplers

    Inputs (34)

    NameTypeDefaultDescription
    adaptive_orderBOOLEANtrue
    risk_sensitivityFLOAT1.000–4
    stochastic_adaptation_strengthFLOAT0.500–1
    minimum_stochastic_multiplierFLOAT0.250–1
    trajectory_correctionBOOLEANfalse
    video_correction_strengthFLOAT0.150–1
    audio_correction_strengthFLOAT0.050–1
    correction_boundFLOAT0.500–2
    endpoint_fidelity_fractionFLOAT0.150–0.5
    s_noiseFLOAT1.000–2
    max_stageINT31–3
    debug_telemetryBOOLEANfalse
    telemetry_prefixSTRINGrefdelta_trajectory
    calibration_captureBOOLEANfalse
    calibration_idSTRINGrefdelta_calibration
    stochastic_control_modeCOMBOlegacy_global3 options: legacy_global, streamwise, spatiotemporal_stability
    video_stochastic_strength_scaleFLOAT1.000–2
    audio_stochastic_strength_scaleFLOAT1.000–2
    static_video_stochastic_adaptation_strengthFLOAT0.500–1
    video_stability_restore_strengthFLOAT1.000–1
    video_stability_motion_lowFLOAT0.0200–2
    video_stability_motion_highFLOAT0.1000–2
    video_stability_diffusion_lowFLOAT0.0200–2
    video_stability_diffusion_highFLOAT0.1500–2
    video_stability_diffusion_weightFLOAT0.500–1
    video_stability_normalization_floorFLOAT0.100.001–1
    video_stability_gammaFLOAT1.000.25–4
    video_stability_spatial_radiusINT20–8
    video_stability_temporal_radiusINT20–8
    video_stability_emaFLOAT0.700–0.99
    video_stability_start_fractionFLOAT0.100–1
    video_stability_full_fractionFLOAT0.300–1
    stochastic_gate_slew_limitFLOAT0.000–1
    debug_stability_mapsBOOLEANfalse

    Outputs (1)

    NameTypeDescription
    samplerSAMPLER