MiniMax-H3 Multishot — Seamless Chain: multi-shot scenes that render as one continuous take (picture + audio)

Fixed in 2.1.1 (user-reported, same day)<ul><li><code>context_pin</code> died when ComfyUI-H3-Motion-Context was installed. Both packs patched the same ComfyUI method and Motion-Context refuses to stack on an unrecognised wrapper, so its payload patch failed and the chain errored. This pack's wrapper now does everything theirs does and declares their compatibility marker, so whichever loads first owns the site and the other stands down. Load order no longer matters. Verified with a live <code>context_pin</code> render.</li><li><code>seamless_tail</code> crashed mid-chain with Motion-Context installed ("only first/last keyframe anchors are supported") - after your first shot had already rendered. It needs interior keyframe anchors, which conflict with that pack; it now stops before any sampling with the alternatives named: use <code>context_pin</code>, or <code>first_frame</code>, or remove that pack.</li><li><code>seamless</code> often reads as a cut - now labeled. It is a legacy latent-only soft pin kept for comparison; the model satisfies it loosely. For a real join use <code>context_pin</code> or <code>first_frame</code>. The tooltip and settings reference now say so plainly.</li></ul>Why these never showed in testing here: an install-layout difference disabled the conflict detection on the dev machine. That detection is fixed, and release testing now runs on a packaged clean install so the class cannot slip through again.Everything you need is in the zip. One download: both node folders, all three workflows, and the full documentation. Nothing else to fetch, nobody to ask.Install<ol><li>Unzip. Copy both node folders into <code>ComfyUI/custom_nodes/</code>:<pre><code>ComfyUI-H3-Multishot/ the sampler and helper nodes
ComfyUI_JoyAI_Echo_GGUF_Nodes/ the LLM prompt writer (full workflow only)</code></pre></li><li>Restart ComfyUI. ComfyUI v0.30.0 or newer is required — that is the release with native MiniMax-H3 support.</li><li>Load a workflow from <code>workflows/</code> through the workflow menu.</li></ol>The full workflow needs five packs (two are in this zip): the writer pack below, <code>ComfyUI-H3-Motion-Context</code> for the <code>context_pin</code> default, <code>RES4LYF</code> for the <code>beta57</code> scheduler, and <code>ComfyUI-sol-attn</code> + <code>comfyui-minimax-h3-blockcache-T8</code> for the VRAM panel; <code>ComfyUI-Custom-Scripts</code> adds the script preview. ComfyUI validates every node class before it will queue, so a missing pack stops the whole workflow rather than just its own feature — <code>INSTALL.md</code> lists how to remove each one instead if you would rather not install it. CORE needs none of them, and that is tested on a clean install.The writer pack is RealRebelAI's (<code>github.com/RealRebelAI/ComfyUI_JoyAI_Echo_GGUF_Nodes</code>), modified so the workflow's join rules actually reach the model; <code>NOTICE_RIFT_MODIFICATIONS.md</code> inside it lists every change. If you already have that pack, replace it with this copy. The CORE workflow does not need it at all.Models you need<pre><code>checkpoint MiniMax-H3 ref2va (GGUF Q8_0 / Q5_1 / Q4_0) -&gt; models/diffusion_models
text encoder qwen3vl minimax_h3 (+ its -mmproj sidecar) -&gt; models/text_encoders
video VAE minimax_h3_video_vae -&gt; models/vae
audio VAE minimax_h3_audio_vae -&gt; models/vae</code></pre>GGUF quants: huggingface.co/joeygambino/MiniMax-H3-GGUF — Q8_0 for 32 GB, Q5_1 for 24 GB, Q4_0 below that.GGUF encoder pairing. ComfyUI-GGUF matches the <code>-mmproj</code> vision sidecar to the encoder by filename, in the encoder's own folder. Rename either, or split them up, and it loads the encoder without its vision tower — which presents as the model ignoring your reference image. This pack's CLIP loader raises instead of continuing blind, uses the only mmproj beside the encoder when there is exactly one, and takes an <code>mmproj_name</code> widget so you can point at the file directly.Which workflow<ul><li>H3_Seamless_Chain_CORE — start here. The same seamless chaining with zero third-party packs. Type shots into the script box and queue.</li><li>H3_Seamless_Chain_v2 — everything: master controls, LLM writer, VRAM panel, identity and voice anchors, episode/batch prompt source, boundary plates, audio spine. Optional lanes are gated off by default.</li><li>H3_Keyframes — one clip, anchors at chosen frame positions, per-anchor condition strength.</li></ul>The two things that stop people on the first run1. The prompt writer needs a model you have pulledThe full workflow points at a local Ollama with <code>model_name = qwen3:14b</code>. If it is not pulled, the first queue stops immediately:<pre><code>LLM API error 404: model 'qwen3:14b' not found</code></pre>Fix: <code>ollama pull qwen3:14b</code>. Any OpenAI-compatible endpoint works — its URL in <code>base_url</code>, its exact tag in <code>model_name</code>. <code>ollama list</code> prints the tags you have, and it must match character for character.No LLM at all? Set the master panel's <code>use_file_prompts</code> to manual entry, delete the writer, and feed your own script into the sampler's <code>script</code> input — one prompt per shot, separated by <code>---</code> on its own line. CORE already works this way.2. A local writer will fight the video model for the cardTurn on <code>unload_model_after</code> on the writer. It frees its own model from Ollama the moment the script is written. Without it the model stays resident for the server's default five minutes — your whole first shot. ComfyUI's own eviction cannot reach it, because Ollama is a separate process with its own allocator, and Ollama's OpenAI-compatible endpoint has no <code>keep_alive</code> field to ask with; the switch calls the native endpoint, which honours it. On under 32 GB, prefer a remote endpoint entirely.Settings: start here, change nothing<pre><code>checkpoint ref2va sampler euler
continuity context_pin scheduler beta57 (full) / beta (CORE)
steps 14 fps 24
frames/shot 362 (~15.1s, the trained maximum)
resolution 1280x736 landscape or 768x1344 vertical</code></pre><code>beta57</code> comes from RES4LYF, not stock ComfyUI. Measured on an identical seed it scored 10/10 for lip-sync against 8/10 for stock <code>beta</code>, with image quality, skin texture, artifacts and audio judged equal — so the full workflow ships it and lists RES4LYF as required, while CORE ships <code>beta</code> and keeps its zero-third-party-pack promise. One widget either way.Leave every VRAM switch off and the reserve at 0, and try a render before touching any of it. The activation reserve measures each shape and conditioning payload as it renders and sizes the pool itself; it holds on 24 GB cards as well as 32 GB. A hand-set reserve overrides that measurement, so a number that suited one shape becomes wrong for the next. Those switches exist to dig out of a spill the console has already named, not for pre-emptive tuning.Resolution cannot change mid-chain, and the mux must stay at 24 fps — other rates audibly shift voice accents. Dial-by-dial reference in <code>SETTINGS.md</code>.Writing a script that chains cleanlyThe previous shot's last ~1 second is replayed at the head of the next and discarded. Four rules follow, and breaking them is what produces mid-word chops and pose jumps:<ol><li>Open holding. Every shot after the first opens in the previous shot's exact closing arrangement, with no dialogue for ~2 seconds. Give it real micro-motion — a breath, a weight shift — so it does not read as a freeze.</li><li>Land settled. Every shot ends with ~2 seconds of quiet, back in a stable arrangement, all dialogue finished.</li><li>Never split a line across shots. Dialogue plus 4 seconds of hold and settle must fit the shot length. If it does not fit, move the whole line to the next shot.</li><li>Repeat descriptions word-for-word. Character appearance and the room/light description, byte-identical in every shot. An unnamed light source gets reinvented per shot, and that is where colour drift starts.</li></ol>The LLM writer applies these for you. Hand-written scripts must follow them — <code>PROMPTING.md</code> has a worked four-shot example, and <code>example_script.txt</code> is ready to paste.How the chaining works<code>context_pin</code> carries the previous shot's last 22 frames as raw latents — never decoded to pixels and re-encoded — placed at interior keyframe coordinates, with a timeline-placed audio reference alongside. The regenerated head is trimmed on decode. Colour, motion and voice cross the boundary as data rather than as a description.Motion is the clearest case. Hand the next shot a single frame and it knows position but not velocity, so pace can reset at the boundary. Measured on a steady-pace walk: a single-frame anchor with no memory bank wobbled at the join; <code>context_pin</code> held it, and so did the memory bank on its own.<code>first_frame</code> is the alternative — the model's own trained hand-off, no extra pack, and what CORE ships with. <code>cut</code> for episodic work.Identity and voice<ul><li>Nothing wired — the frame relay plus verbatim descriptions hold a face surprisingly well. A ~40 s two-character scene held both faces with no reference images at all.</li><li><code>self_anchor_voice</code> (on) — shot 1's own rendered voice becomes the reference for every later shot. No file needed; write shot 1 with a clean solo line.</li><li><code>voice_ref</code> — a clean solo speech clip, pinned across the whole chain including shot 1.</li><li><code>reference_images</code> — character portraits carried into every shot as <code>&lt;Picture 1..N&gt;</code>. Bind them in the prompt text.</li><li><code>seed_per_shot</code> (leave on) — measured: varying the seed per shot holds the face; one seed for every shot drifted both face and voice. Identity lives in the conditioning, not the seed.</li></ul>When something goes wrong<ul><li>404, model not found — the writer's model is not pulled. See above.</li><li>A word clips at a join — the script put dialogue too close to a boundary. Move the whole line; do not split it.</li><li>Sharpening increases every shot — the texture ratchet. Set <code>chain_gain_control</code> to <code>flatten</code>; worth it past about 5 shots.</li><li>Stalls at 0 steps, or runs several times slower than usual — a VRAM spill, the driver paging to system RAM instead of erroring. The console now names it. Raise the reserve, or drop resolution, frames, or reference payload.</li><li>Red or missing nodes — an optional pack is not installed. Delete those nodes, or use CORE.</li><li>GGUF architecture error — the pack teaches ComfyUI-GGUF the <code>minimax_h3</code> architecture at startup. If it persists, run <code>python apply_gguf_arch_patch.py</code> from the pack folder once and restart.</li><li>Audio dulls on a very long chain — expected; restart the chain on a scene cut, where a fresh start costs nothing.</li></ul>What changed in 2.1<ul><li>The full workflow now works on a clean install. It referenced a prompt-source node that had never been published, and drove the writer through inputs the upstream writer pack does not have — so the boundary rules never reached the model. It rendered, and it rendered worse than it should, with no error to explain why. Both fixed: that node ships here as <code>RiftPromptSource</code>, and the rules are written into the workflow's own system prompt as well as carried by the writer pack in this zip.</li><li>The chaining sampler's anchor switches now do something. <code>voice_ref</code>, <code>reference_images</code>, <code>self_anchor_voice</code>, <code>preview_first_shot</code>, <code>two_pass_upscale</code>, <code>reference_image_size</code> and the sampler/scheduler overrides were drawn on the canvas but absent from the class, so ComfyUI stripped them before execution. All real now, render-verified.</li><li><code>unload_model_after</code> on the writer, described above.</li><li>SHOT COUNT on the master panel drives the sampler and the writer together so they cannot disagree; prompt source switches between a manual scene box and a prompt set, lazily.</li><li>Node titles no longer name a checkpoint or a switch position — a title like <code>H3 model (fl2va)</code> is a lie the moment you change the model.</li></ul>Two-pass upscale cannot be combined with <code>context_pin</code> or <code>latent_handoff</code>, or with an audio spine: those carry raw latents, or one locked denoise trajectory, across the join, and a two-pass render preserves neither. The node stops with an error naming the conflict rather than quietly producing a weaker join. Two-pass is available on <code>cut</code>, <code>seamless</code>, <code>seamless_tail</code>, <code>first_frame</code> and <code>flf_chain</code>.CreditsPrompt writer: RealRebelAI (<code>ComfyUI_JoyAI_Echo_GGUF_Nodes</code>, modified — see the NOTICE in the zip). <code>context_pin</code>: NikoDemon80 (<code>ComfyUI-H3-Motion-Context</code>). Two-pass upscaling: Tr1dae (<code>ComfyUI-MiniMaxH3_LatentUpscaler</code>).

minimaxH3MultishotSeamlessChain_v211.zip

v2.1.1

v.2.2.5

v2.2.4 Multi-Ref+Vid-Ref

v2.2.3 More Mem Fix

v2.2.2 - Glasses?

v2.2.1 - Bugfix

v2.2 - Big Update

v2.1.2

v2.1 Bugs in my bugfixes

v2.0 - Seamless Chain

v1.5 Auto-Voice Ref+LoRAs

v1.4.1 - Bugfix release

v1.4

v1.3

v1.2.1

v1.2

v1.1

v1.0

Files with SHA256: 205f1dcc4399fe08faa1f725bdcc2ff48d50be7bef1dd4310defe221e2ee3416