Files
ComfyUI-H3-Continuum-Tiled/README.md
T

8.9 KiB

ComfyUI-H3-Continuum 3.4.0

Long-form MiniMax H3 video generation for ComfyUI with restartable chunks, persistent references, Driving Audio, Video Reference, seam correction, and optional Spectrum interoperability.

H3 Continuum V3.4 workflow overview

V3.4 is the current release candidate. V3.3 legacy nodes remain available for existing workflows.

Example workflows

The templates include optional external nodes such as Spectrum, Video Helper Suite, rgthree, EasyUse, and RTX Video Super Resolution. Install, replace, connect, or bypass them according to your installation. Media and acceleration choices remain under user control.

What's new in V3.4

Driving Audio

Driving Audio is the primary V3.4 audio path.

  • Source audio guides each chunk at its absolute sequence position.
  • The original effective stream is preserved for final output.
  • Generated audio and Audio Seam processing are bypassed while Driving Audio is active.
  • Audio is not independently rewritten at every chunk boundary.
  • Perfect lip sync is not guaranteed; results still depend on H3, source material, prompts, and sampling.

Video Reference

Video Reference provides a persistent native H3 video reference across all chunks.

  • It guides motion, framing, timing, and appearance.
  • It is not a direct pixel-copy or deterministic identity-transfer system.
  • Video and audio are independent. Route a loader's IMAGE output to Video Reference and AUDIO output to Driving Audio.
  • Source decoding and frame-rate conversion remain loader responsibilities. Continuum does not impose an unnecessary forced 24 fps conversion.
Video Reference Size Purpose
Efficient - 0.4 MP Default; lower token cost and faster iteration.
Balanced - 0.6 MP More detail at a higher compute cost.
Match Output Largest reference input; potentially much slower and heavier.

Core-first, permissive execution

V3.4 removes or relaxes Continuum-only rejection rules that blocked otherwise runnable Core H3 experiments.

  • Prompt problems prefer warnings and fallback behavior instead of stopping.
  • Unknown upstream/custom wrapper classes are not blanket-rejected.
  • There is no model allowlist and no automatic model replacement.
  • The obsolete strict_compatibility control is removed from the V3.4 interface.
  • Current Core PackedLayout behavior is supported without requiring the removed legacy frame_count argument.

Hard stops remain only for states that cannot execute safely, including corrupt latent topology, incompatible assembly data, invalid persisted revisions, or unusable mandatory payloads.

Cleaner interface

The public nodes focus on normal production controls. Developer diagnostics and detailed reports are available through ComfyUI settings.

V3.4 sampler, Spectrum, and assembler

Timeline paths

Experimental Timeline Video and earlier reference/timeline audio paths are no longer public V3.4 inputs. They are hidden rather than destructively removed. Existing V3.3 workflows can continue through legacy nodes.

Installation

Search for H3 Continuum or Continuum in ComfyUI Manager, or install manually:

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

Restart ComfyUI after installation or update.

V3.4 nodes

H3 Continuum Sampler V3.4

Main inputs:

  • model, clip, video_vae, sampler, sigmas
  • Sequence Prompt
  • first_frame, last_frame
  • reference_image_1 through reference_image_3
  • Video Reference
  • driving_audio, audio_vae

Outputs:

  • video_latents, audio_latents
  • assembly_plan, status
  • driving_audio

Visible controls:

  • Prompt Format, chunks, chunk_seconds
  • width, height, continuity
  • base_seed, control after generate
  • audio_continuity
  • Run Storage
  • Reference Size
  • Video Reference Size

H3 Continuum Assemble + Seam V3.4

Inputs: images, audio, assembly_plan, and driving_audio.

Controls: Audio Seam and Video Seam.

When Driving Audio is connected, preserved source audio is selected for final output and generated audio seam processing is bypassed.

Connection order

H3 model / CLIP / Video VAE / sampler / sigmas
                         |
                         v
              H3 Continuum Sampler V3.4
                 |       |        |
          video_latents  |   assembly_plan
                         |
                  audio_latents

video_latents -> Core VAE Decode ------- images --+
audio_latents -> Core VAE Decode Audio -- audio  --+--> H3 Continuum Assemble + Seam V3.4
assembly_plan -------------------------------------+
driving_audio -------------------------------------+

For a source video with sound:

Video loader IMAGE -> Video Reference
Video loader AUDIO -> driving_audio

The supplied templates use Video Helper Suite for this split. Any compatible IMAGE/AUDIO loader may be substituted.

Prompt formats

Timeline:

[0-5s] First section: action, camera movement, and scene progression.
[5-10s] Continue from the exact final state of the previous section.
[10-15s] Continue naturally without resetting the scene.

List prompts use --- separators. Fixed reuses one prompt for every chunk. Auto detects the available structure. If a timeline cannot be parsed, V3.4 reports a warning and uses an applicable fallback rather than rejecting an otherwise runnable workflow.

Run Storage

Run Storage preserves completed chunks and can reuse them after restarting ComfyUI. Regenerate From selects the first chunk to regenerate; earlier compatible chunks remain unchanged.

Regenerate From

  • Use a fixed seed for reproducible resume.
  • Changing persistent models, LoRAs, references, prompts, resolution, or sampling settings can create a new revision.
  • Unknown upstream node classes no longer cause rejection by themselves; reuse still depends on compatible observable contracts and hashes.

Spectrum interoperability

Spectrum is optional. Current Spectrum releases officially support H3 Continuum Interop API v1.

  • Chunk 1 uses the normal initial path.
  • Chunk 2 and later request Actual Prefix 2.
  • Successful continuation logs accepted H3 Continuum API v1, actual prefix=2.
  • Unsupported Spectrum versions fall back without a private patch.

See Spectrum v0.2.15 H3 Continuum interoperability.

Turbo LoRA and Spectrum are not mutually exclusive. Quality and speed remain workflow-dependent.

Issue and pull-request response

Issue #3

V3.4 removes blanket rejection of unknown upstream/custom class names. Run Storage evaluates the observable generation contract instead of treating an unfamiliar wrapper as automatically incompatible.

See Issue #3.

Issue #4

V3.4 follows the current Core H3 layout contract and no longer requires the legacy frame_count parameter. The old strict-compatibility toggle is not part of the public interface.

See Issue #4.

Pull request #1

Relevant current-Core compatibility ideas are selectively adapted to V3.4 rather than copying the pull request wholesale. The pull request itself is not described as merged.

See Pull request #1.

Pull request #2

The proposed eight-reference expansion and additional high-resolution assembly RAM changes are not included in this update. They remain a separate review item.

See Pull request #2.

Current validation status

V3.4 has been exercised locally with:

  • 1, 2, and 3 chunks
  • standard and Turbo paths
  • Spectrum enabled and disabled
  • I2VA, Reference, and selected FL2VA configurations
  • Driving Audio with short, exact-length, and longer sources
  • Video Reference with source audio routed separately
  • 0.4 MP and 0.6 MP reference sizing
  • Run Storage reuse and selected-chunk regeneration
  • Core VAE Decode and final assembly

No OOM was observed in the cited recent local V3.4 checks, including two-chunk 800 x 800 runs. This is not a universal memory guarantee. Model precision, LoRAs, source resolution, optional nodes, GPU, and RAM affect memory use.

Limits

  • Continuation does not guarantee frame-perfect identity or motion.
  • Video Reference guides H3; it does not reproduce every source frame.
  • Driving Audio preserves selected audio, but visual lip synchronization remains model-dependent.
  • Match Output can be substantially slower than 0.4 MP or 0.6 MP.
  • Seam correction may keep the native boundary when a proposed correction is not safer.
  • Optional template nodes must be installed, replaced, or bypassed by the user.

License

See LICENSE.