# ComfyUI-H3-Multishot-Advance Focused MiniMax-H3 multi-shot video nodes for ComfyUI. This project is derived from the MIT-licensed [ComfyUI-H3-Multishot](https://github.com/jlucasmcrell/ComfyUI-H3-Multishot) work by RiftCast / jlucasmcrell. This repository contains ComfyUI custom-node code. Model files are not bundled. The Advance fork keeps the H3 long-form workflow focused: a small node surface, a unified loader, centralized controls, and a shot cache designed for fast iteration on multi-scene prompts. A key Advance feature is the Multishot Advance Project. It gives long multi-shot renders a reusable project/session layer: render a sequence, close ComfyUI, reopen the same named project later, edit a shot, and continue from the first changed shot while safe earlier cached state is reused. This is meant for iterative video work, not for storing final video outputs. ## Example Workflows - [Full-Ref](example_workflows/H3-Multishot-Adv_Full-Ref_Ex.json): Direct single-reference workflow. It can reuse compatible cached work and resume from the first changed clip, but only during the current ComfyUI session. - [Full-Ref With Project](example_workflows/H3-Multishot-Adv_Full-Ref_Ex_With_Project.json): Persistent single-reference workflow. It can be reopened after restarting ComfyUI to continue or modify the sequence from the first changed clip. - [Two-Ref](example_workflows/H3-Multishot-Adv_Full-Ref_Two-Ref_Ex.json): Direct two-reference workflow with `1,1` subject mapping. Compatible cached work can be reused from the first changed clip during the current ComfyUI session. - [Two-Ref With Project](example_workflows/H3-Multishot-Adv_Full-Ref_Two-Ref_Ex_With_Project.json): Persistent two-reference workflow. It can be loaded after restarting ComfyUI and then continued or modified from the first changed clip. - [Video Edit Without Audio](example_workflows/H3-Multishot-Advance_Video-Edit_No-Audio.json): Uses an existing video as the visual structure for changing appearance or action while preserving its camera, timing, environment, and scene continuity; it does not use the source audio as a voice reference. - [Video Edit With Voice Timbre](example_workflows/H3-Multishot-Advance_Video-Audio-Timbre_Edit.json): Extends the video-editing workflow with source-audio conditioning so the performer can deliver newly written dialogue while retaining the recognizable vocal character of the voice in the original video (speech may extend due to the source audio). For complete setup instructions, Prompt Builder field guidance, reference-role examples, dialogue rules, video-editing workflows, and troubleshooting, see the [User Guide](user_guide/User%20Guide.md). ## What this node pack is for According to the [official MiniMax-H3 specifications](https://huggingface.co/MiniMaxAI/MiniMax-H3#system-overview), H3 generates 4–15-second clips at 24 FPS. This pack chains those clips into a longer sequence while keeping the workflow practical for prompt iteration: - write one script with independent target clips separated by `---`, using `[Shot N]` for camera shots/cuts inside each clip; - change a later shot without re-rendering every earlier compatible shot; - save a named project, close ComfyUI, reopen it later and continue editing from the first changed shot; - keep model loading, resolution, seed, frame count, sampler and scheduler in one clean workflow lane; - reuse raw cached shot state instead of rebuilding unchanged clips from final MP4/video output. The main goal is iteration speed without changing the generation path for uncached shots. ## Nodes Core nodes: | Node | Purpose | | --- | --- | | `MultishotAdvanceMultiModelLoader` / Multishot Advance Multi Model Loader | Loads the H3 diffusion model, CLIP/text encoder, video VAE and audio VAE from one node. `clip_type` defaults to `minimax`. | | `MultishotAdvanceControls` / Multishot Advance Controls | Central render controls: aspect ratio, megapixels, snap multiple, frames per shot, seed, steps, sampler, scheduler and shot count. | | `MultishotAdvancePromptBuilder` / Multishot Advance Prompt Builder | Builds a reusable multi-shot script that can connect directly to the Sampler or pass through the optional Project node. | | `MultishotAdvanceSampler` / Multishot Advance Sampler | Main multi-shot sampler with continuity options, prompt splitting and shot cache support. | | `MultishotAdvanceVideoSavePlayer` / Multishot Advance Video Save/Player | Saves and previews H3 video output with codec/audio controls and embedded workflow metadata. | | `MultishotAdvanceProject` / Multishot Advance Project | Optional project/session node that lets users save a named multi-shot project, close ComfyUI, reopen it later, edit shots, and resume rendering from the first changed shot. | Support nodes: | Node | Purpose | | --- | --- | | `MultishotAdvanceCartridgeLoader` / Multishot Advance Cartridge Loader (.riftcast) | Loads `.riftcast` character/project cartridges when that format is used. | | `MultishotAdvanceMarkdownPreview` / Multishot Advance Markdown Preview | Displays connected STRING/TEXT or markdown in the node UI and passes the same text through from `text_out`. | | `MultishotAdvanceProjectCachePreview` / Multishot Advance Project Cache Preview | Plays compatible cached project clips without sampling, model loading, or VAE decoding. | | `MultishotAdvanceSpeedBoosters` / Multishot Advance Speed Boosters (optional packs) | Applies optional H3 speed/VRAM helper patches when the matching external packs are installed. | ### Loader activation memory reserve `activation_reserve_gb` on Multishot Advance Multi Model Loader controls how activation memory is estimated for the selected H3 model: - `-1` is the default; any negative value keeps ComfyUI's stock memory estimator and disables the H3 reserve override. - `0` enables H3 AUTO mode, which sizes the reserve for the actual render shape and refines its estimate from measured peak usage. - A positive value pins that many GiB as a manual reserve. A manual value is resolution-specific and may perform poorly when reused for another render shape. ## Prompt format The sampler treats `---` and `[Shot N]` as different levels: - `---` starts the next independent target video clip and therefore the next sampler execution. - `[Shot 1]`, `[Shot 2]`, `[Shot 3]` describe camera shots/cuts inside one target clip. Every independent `---` clip restarts at `[Shot 1]`. Plain text is accepted, but each block is normalized into an official H3 contract before conditioning: ```text [Shot 1] First target clip... --- [Shot 1] Second target clip... [Shot 2] At 00:03.000, Cut to a closer view... --- [Shot 1] Third target clip... ``` JSON is also accepted: ```json {"prompts": ["Shot 1 prompt...", "Shot 2 prompt..."]} ``` When `shot_count` is higher than the number of prompt blocks, the sampler keeps the existing fallback behavior and reuses the previous prompt for missing shots. ### Base task modes: T2VA, I2VA, FL2VA and L2VA Base prompts use exactly these three sections: ```text integrated_multimodal_description: [Shot 1] ... overall_soundscape: ... non_diegetic_music: N/A ``` The sampler resolves the task mode from actual keyframe tensors, not from the checkpoint filename, continuity selector or prompt wording: | Runtime keyframes | Resolved task | Required text behavior | | --- | --- | --- | | no first/last frame | `T2VA` | no image-alignment preamble | | `first_frame` only | `I2VA` | canonical 0.00-second first-frame alignment | | `first_frame` + `last_frame` | `FL2VA` | canonical first/final alignment using the real duration | | `last_frame` only | `L2VA` | canonical final-frame alignment using the real duration | `start_image` is an identity/reference seed retained for compatibility. It is not a concrete I2VA first frame. Use `first_frame` and `last_frame` when the opening or ending composition must be fixed. ### Full-reference contract When real reference items are present, the final prompt uses exactly six sections in this order: ```text subject_definitions: ... summary: [reference generation] ... retention_analysis: ... detailed_description: [Shot 1] ... overall_soundscape: ... non_diegetic_music: N/A ``` Picture, Video and Audio labels are assigned from the actual runtime reference registry. A manually written label without a matching runtime item is rejected. Identity-only pictures belong to their Subject definition; concrete keyframes, storyboards and video/audio roles receive their own role-appropriate definition and retention marker. Base `images=` alignment and full-reference `minimax_ref_items` are never mixed in the same target clip. `global_context:` is accepted only as a legacy importer header. Its content is migrated into the official description section and the header is not emitted in a final prompt. The contracts follow the official MiniMax guides: - [MiniMax-H3 base prompt writing guide](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md) - [MiniMax-H3 full-reference prompt writing guide](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md) ### Task mode is not continuity `continuity` controls how separate generated clips hand state to the next clip: `cut`, `first_frame`, `flf_chain`, `context_pin`, `latent_handoff` and related modes affect inter-clip memory, pins or joins. It does not declare T2VA/I2VA/ FL2VA/L2VA. For example, `continuity=first_frame` can create a generated handoff frame for later clips, while the first target clip remains T2VA unless a real user `first_frame` tensor is connected. ### Structured dialogue and silent clips Use stable speaker events and exact dialogue tags: ```text [Shot 1] (S1) turns toward the control panel. (S1) [English] The signal is stable. ``` Every complete statement, question, or exclamation inside `...` must end with `.`, `?`, or `!` immediately before ``. Do not use quotation marks alone to indicate speech. Text such as a neon sign reading `"OPEN ALL NIGHT"` remains on-screen text and does not activate voice references. `speech_policy=force_silent` adds positive observable behavior to the description and soundscape: relaxed closed mouths, visible performance, environmental ambience and physical action sounds. It does not append negative CFG-style prose outside the official sections. ## Multishot Advance Prompt Builder Multishot Advance Prompt Builder is an optional authoring node that can connect directly to the Sampler for session-only work or pass through the Project node for persistent projects. Put the reusable character/subject description, retention rules, global scene notes and visual style in the builder once, then write only the per-clip action beats in `shot_script`. Direct wiring without a Project: ```text Multishot Advance Prompt Builder.script_out -> Multishot Advance Sampler.script Multishot Advance Prompt Builder.shot_count_out -> Multishot Advance Sampler.shot_count Multishot Advance Prompt Builder.reference_subjects_out -> Multishot Advance Sampler.reference_subjects Multishot Advance Prompt Builder.compiled_preview -> Multishot Advance Markdown Preview.text ``` Persistent wiring through a Project: ```text Multishot Advance Prompt Builder.project_name_out -> Multishot Advance Project.project_name_override Multishot Advance Prompt Builder.script_out -> Multishot Advance Project.script Multishot Advance Prompt Builder.shot_count_out -> Multishot Advance Project.shot_count Multishot Advance Prompt Builder.prompt_builder_state -> Multishot Advance Project.prompt_builder_state Multishot Advance Project.project -> Multishot Advance Sampler.project Multishot Advance Project.script_out -> Multishot Advance Sampler.script Multishot Advance Project.shot_count_out -> Multishot Advance Sampler.shot_count Multishot Advance Prompt Builder.reference_subjects_out -> Multishot Advance Sampler.reference_subjects Multishot Advance Prompt Builder.compiled_preview -> Multishot Advance Markdown Preview.text ``` The Builder creates an editable preview, while the Sampler automatically adapts the final prompt to the references and keyframes actually connected at render time. When a project is rendered with `prompt_builder_state` connected, `project.json` also stores the builder's editable fields. After reopening ComfyUI, select the saved project in the Prompt Builder's `project_picker`; its prompts and settings are restored automatically. The Builder and Project node populate their pickers from existing folders in `ComfyUI/user/multishot_advance_projects`. New Prompt Builder authoring helpers are optional and default-safe: - `style_preset` adds a reusable visual style bank such as cinematic, documentary, anime, product commercial, music video, horror or fashion editorial. `Off` adds nothing. - `camera_preset` adds a camera-language bank such as static, slow push-in, handheld follow, tracking, close-up, wide establishing, aerial or arc/orbit. `Off` leaves camera wording fully manual. - `reference_image_role` controls how `

Multishot Advance Markdown Preview

Inputs (1)

Outputs (1)