Nodes/H3 Continuum/H3 Continuum Sampler V3.7
ComfyUI Node

H3 Continuum Sampler V3.7

The V3.6 you know, plus one experimental guide socket

By ukr8b3g-cmyk·Created 29 days ago·Updated a day ago· 73
H3 Continuum Sampler V3.7
  • model
  • clip
  • video_vae
  • sampler
  • sigmas
  • first_frame
  • last_frame
  • reference_image_1
  • reference_image_2
  • reference_image_3
  • reference_video_1
  • driving_audio
  • audio_vae
  • reference_audio_1
  • reference_audio_vae
  • guide
  • video_latents
  • audio_latents
  • assembly_plan
  • status
  • driving_audio
  • refine_context
sequence_prompt
prompt_modeAuto
chunks3
chunk_seconds5.0
width1344
height768
continuityBalanced — 22 frames
base_seed0
audio_continuitytrue
diagnosticsBasic
reroll_from_chunkAuto
reroll_nonce0
strict_compatibilitytrue
debugfalse
show_previewtrue
run_storageOff
run_name
reference_sizeMatch Output
project_id
video_reference_sizeEfficient - 0.4 MP
continuation_backendStandard

If you already run V3.6, you already know this node

H3 Continuum Sampler V3.7 is the current release path of the pack, and the honest summary is: it is the V3.6 sampler with exactly one extra optional socket. Same chunked continuation, same Masked AV behavior, same Run Storage, same production defaults - the pack is explicit that V3.7 does not change any V3.6 defaults. The one new thing is a guide input that accepts a Still Image Guide, and that one new thing is worth reading about before you plug it in, because it's genuinely experimental.

So when do you reach for this node instead of the V3.6? If you never touch the guide socket, it's a straight upgrade in name only - same outputs, same wiring, same workflow. If you want to pin one specific frame of your long-form video to a particular image, this is the node that lets you do that while keeping everything else identical.

How the guide works

The guide input takes a special object type produced by the pack's H3 Continuum Still Image Guide V3.7 node - you don't build the guide inline, you make it with that two-input prep node and wire it across. That guide packs an image plus an absolute frame number on the final 24 fps timeline. When the V3.7 sampler runs, it resolves that absolute frame to whichever physical sampling group owns it and injects the image as a Core minimax_keyframes entry on only that group. Chunks before and after it sample normally.

Here's the part the README is blunt about: Still Image Guide is on Production HOLD. Core's Add Guide uses hard-anchor semantics - the image is treated as a hard target for that frame, so it can cause an abrupt trajectory change at the anchor and can redirect later motion. It is not a smooth "drift toward this image" control. If your mental model was "lens the scene toward this reference over a few seconds," disabuse yourself now. If your actual goal is "frame 156 must look like this exact shot," that's what it's for.

Inputs and outputs

Everything from V3.6 is here, unchanged: model, clip, video_vae (image-conditioning encode only - Continuum never decodes with it), sampler, sigmas, sequence_prompt, chunks, chunk_seconds (5 default, 5–15 validated), width/height (multiples of 32), continuity, base_seed, audio_continuity, continuation_backend, run_storage/run_name/reroll_from_chunk, and the same optional first_frame, last_frame, reference_image_1–3, reference_video_1, driving_audio, and reference-audio inputs. Plus the new one:

  • guide (optional) - the Still Image Guide object from the guide-prep node. Leave disconnected and you're running the V3.6 production path exactly.

Outputs are identical to V3.6: video_latents and audio_latents (feed to Core VAE Decode), assembly_plan (into H3 Continuum Assemble + Seam), status (a string - read it, it reports resolved transport and chunk reuse), driving_audio, and refine_context (for Second Pass / Hi-Res Fix). A word of advice: if you're comparing guide-on vs guide-off behavior, fix your seed, because an abrupt anchor plus a new seed is two variables at once.

Install and setup

Same as every node in this pack - ComfyUI 0.32.0+:

cd ComfyUI/custom_nodes
git clone https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum.git

or search "H3 Continuum" in ComfyUI Manager. Restart after. No extra pip dependencies (the requirements.txt is empty), but you need the MiniMax H3 weights - and remember the H3 Community License excludes the US, EU, UK and South Korea from running them locally, so verify you're in a permitted territory before you start.

The trap to avoid

Treating the Still Image Guide as a continuity tool. The whole point of V3.7's "Stage 2" positioning is that the guide exists to be tested, not to be your default workflow. The pack's own correctness gates validated that the guide maps to the right group, keeps ownership, and isolates non-owner chunks - and still kept it Experimental because the anchor semantics are harsh. Use it when you need a hard keyframe; if you want smooth transitions, that's what driving the sampler with references and strong continuity prompts is for. Don't expect the guide to fix drift it isn't designed to fix.

CategoryMiniMax H3/Continuum

Inputs (37)

NameTypeDefaultDescription
modelMODEL
clipCLIP
video_vaeVAEUsed only to encode image conditioning. T2VA does not use it; Continuum never decodes with it.
samplerSAMPLER
sigmasSIGMAS
sequence_promptSTRINGConnect one Text (Multiline) for the complete sequence.
prompt_modeCOMBOAutoAuto accepts Fixed, list-separated, and timeline prompt styles.
chunksINT31–16Number of sequential Continuum chunks to generate.
chunk_secondsFLOAT5.04–30Target duration shared by every chunk. 5–15 seconds is the recommended and validated range. Values above 15 seconds are supported, but VRAM use and processing time can increase substantially, especially at high resolution.
widthINT134432–16384Output width. Use a multiple of 32.
heightINT76832–16384Output height. Use a multiple of 32.
continuityCOMBOBalanced — 22 framesAmount of prior video context retained at each chunk boundary.
base_seedINT00–18446744073709550000Base seed used to derive deterministic per-chunk seeds.
audio_continuityBOOLEANtrueOn passes prior audio context into continuation chunks. Turn it off only to isolate or replace generated audio.
diagnosticsCOMBOBasic3 options: Basic, Detailed Report, Off
reroll_from_chunkCOMBOAutoAuto resumes the longest compatible saved prefix. Choosing a chunk reuses earlier chunks and regenerates that chunk and everything after it.
reroll_nonceINT00–4294967295Change only when regenerating an explicit chunk and you want a new variation with otherwise identical settings.
strict_compatibilityBOOLEANtrue
debugBOOLEANfalse
show_previewBOOLEANtrue
run_storageCOMBOOffAtomically save raw AV chunks and resume a compatible saved run.
run_nameSTRINGEnter a stable name for this saved run. Compatible chunks are selected automatically.
reference_sizeCOMBOMatch OutputMatch Output is the practical default; Max Identity preserves more reference detail.
project_idSTRINGOptional. Leave blank to derive a stable ID from this sampler node. Run Name remains the explicit override.
video_reference_sizeCOMBOEfficient - 0.4 MPEfficient limits Video Guide Frames to about 0.4 MP; Balanced uses about 0.6 MP; Match Output uses the output pixel area. Source aspect ratio is preserved and smaller sources are not enlarged.
continuation_backendCOMBOStandardStandard uses the V3.6 target-preserving continuation path. With Audio Continuity enabled, Masked AV currently uses Balanced 22; Fast 5, Strong 39, and Auto safely use Reference Context. Compatibility restores the V3.5 Reference Context path for older workflows or comparison. Run Storage identity follows the resolved transport before execution begins.
first_frameoptIMAGEOptional. Leave all image inputs disconnected for T2VA.
last_frameoptIMAGE
reference_image_1optIMAGE
reference_image_2optIMAGE
reference_image_3optIMAGE
reference_video_1optIMAGEOptional video guide. Connect the IMAGE frame batch from a video loader; source-video audio is not included. Frames are interpreted at 24 fps and applied to every chunk. Non-native frame counts are padded by repeating the final frame to the next H3 17k+5 count, up to the one-chunk limit.
driving_audiooptAUDIOOptional original audio timeline. It is used as native H3 guide conditioning and selected unchanged for final output.
audio_vaeoptVAERequired only when Driving Audio is connected. Uses the same Audio VAE encode path as ComfyUI Core MiniMax H3 Add Guide.
reference_audio_1optAUDIOOptional standalone audio reference for H3 conditioning. It is not the audio track of Video Guide Frames. Unlike Driving Audio, it does not replace the generated final audio.
reference_audio_vaeoptVAERequired only when Reference Audio is connected. It encodes the reference for H3 conditioning; generated audio remains the output.
guideoptH3_CONTINUUM_STILL_IMAGE_GUIDEOptional V3.7 Still Image Guide. Only the owning physical sampling group receives the Core minimax_keyframes entry.

Outputs (6)

NameTypeDescription
video_latentsLATENT
audio_latentsLATENT
assembly_planH3_CONTINUUM_ASSEMBLY_PLAN
statusSTRING
driving_audioAUDIO
refine_contextH3_CONTINUUM_REFINE_CONTEXT