ComfyUI-MiniMax-H3-LongMedia README

The project's README from github.com/vizart-vj/ComfyUI-MiniMax-H3-LongMedia. As one markdown file: README.md.

ComfyUI-MiniMax-H3-LongMedia

Production-oriented ComfyUI nodes for MiniMax H3 long-form video/audio generation, native reference editing, MultiClip planning, camera direction, fixed segmentation, lip-sync/redubbing, latent hi-res refinement, and adaptive low-VRAM execution.

screenshot

Current release: 0.5.40

Main Nodes

Legacy internal MiniMaxH3LatentLab... class identifiers remain registered for workflow compatibility.

Installation

Install into:

ComfyUI/custom_nodes/ComfyUI-MiniMax-H3-LongMedia

or install the package from the Comfy Registry.

Package identity:

GitHub:             vizart-vj/ComfyUI-MiniMax-H3-LongMedia
Comfy PublisherId:  noise

Restart ComfyUI after installation/update.

Current Setup Model

New workflows use independent semantic controls:

control_mode
h3_mode
timeline_mode
duration_source
audio_mode

This is the main change in how the project should be understood compared with the public 0.4.40 documentation.

See Operating Modes.

H3 Conditioning

t2va
fl2va
ref2va
hybrid
video_ref_edit

Timeline

single
segmented
multiclip

Duration Ownership

auto
video
audio
manual
longest_input

duration_source controls timeline length only. It does not remove audio references or change final-audio policy.

video_ref_edit

Typical source-character replacement:

video_1 = source video frames
image_1 = replacement identity
audio_1 = source soundtrack or new dub

A Video input is an IMAGE batch and never contains soundtrack data.

For preserve-style modes, Video1+Audio1 can be presented as a native paired source-performance reference while Audio1 also owns the target timing/output waveform.

For audio_mode=lip_sync, Audio1 is intentionally independent from Video1's original facial performance so completely new dialogue or singing can drive the replacement character.

Audio2/Audio3 remain prompt-addressable references for music, percussion, bass, ambience, or other semantic timing. In video_ref_edit, they are conditioning references only; Audio1 remains the sole preserved/passthrough source soundtrack.

See Audio Modes and video_ref_edit.

MultiClip + Cameras

Recommended connection:

Long Media Planner
        ↓ clip_plan
Long Media Cameras
        ↓ clip_plan
Long Media Setup

Use:

timeline_mode = multiclip

Planner owns diegetic scene/action prompts, durations, names, and optional seeds. Cameras owns framing, rig/lens, movement, speed, spatial relation, entity continuity, and transitions.

See:

Segmented Long Form

Use:

timeline_mode = segmented

for one continuous semantic movie split into fixed-duration internal units for VRAM/stability. It is not a storyboard scheduler.

See Fixed Segmentation Prompting.

Two-Stage H3 / Latent Hi-Res

The Long Media Sampler can:

  1. generate a low-resolution Stage-1 denoised x0;
  2. learned-upscale the video latent only;
  3. preserve the audio latent;
  4. rebuild target-grid conditioning;
  5. optionally run an independent same-seed fresh-noise high-resolution H3 pass.

Without Latent Hi-Res, the Refiner remains a continuous zero-noise low-sigma tail.

See Two-Stage Sampling, Latent Hi-Res and Refiner.

Sampler / Memory

Production starting point:

sampler_mode   = auto
memory_mode    = auto
attention_mode = auto

Keep ComfyUI Dynamic VRAM enabled.

Current memory-safety work includes exact Comfy Kitchen query streaming for structurally impossible fused-QKV workloads, repeat-run memory isolation, guarded native INT8 VBAR prefetch on constrained GPUs, and RAM-pressure-aware pinned host memory.

See Sampler, VRAM and Performance Guide.

FastH3 / FastVideo VSA

LongMedia includes isolated compatibility paths for supported H3ddle/PulpCut FastH3 VSA and Kijai FastVideo VSA packages.

These paths use strict structural detection and reset their runtime state when switching back to ordinary H3 checkpoints.

Loop Closure

Loop Closure returns the generated tail toward the opening macro-state in latent/H3 space. It is independent from conditioning/timeline mode and does not use an RGB crossfade as its primary mechanism.

Documentation

Start at docs/README.md.

Important guides:

Example Workflows

Release workflows contain neutral media placeholders rather than user media or local preview paths.

See workflows/README.md.

Third-Party Code

This repository contains adapted third-party components under their respective licenses, including:

See THIRD_PARTY_NOTICE.md and THIRD_PARTY_APACHE_2_0.txt.

Release History

0.5.40 is the release consolidation after public v0.4.40.

Historical release notes remain in docs/ for compatibility/reference. They may use the old workflow_mode terminology.

License

See LICENSE.

ComfyUI-MiniMax-H3-LongMedia (vizart-vj/ComfyUI-MiniMax-H3-LongMedia)

Searching Database…

Что это такое?Набор кастомных нод для ComfyUI, ориентированных на продакшен, которые запускают MiniMax H3 для генерации длинного видео и аудио: редактирование по референсу, планирование MultiClip, управление камерой, фиксированная нарезка на сегменты, lip-sync и переозвучка, уточнение в высоком разрешении через латент, а также работа с безопасным расходом видеопамяти при её нехватке.
Это отдельное приложение или что-то, что я добавляю в ComfyUI?Это плагин, а не приложение: ноды устанавливаются в уже настроенный ComfyUI (в папку custom_nodes или как пакет из Comfy Registry) и после этого появляются как ноды в ваших воркфлоу.
Как добавить это в ComfyUI?Установите его в папку custom_nodes ComfyUI или скачайте пакет из Comfy Registry, а после установки или обновления перезапустите ComfyUI.
Что мне нужно, кроме самого плагина?Рабочая установка ComfyUI с чекпоинтом H3, из которого можно делать сэмплирование; в README за отправную точку для продакшена принята включённая опция Dynamic VRAM в ComfyUI.
Подойдут ли старые туториалы для версии 0.4.40?Частично: 0.5.x — это консолидация после публичной версии 0.4.40, и в новых воркфлоу используются независимые семантические контролы (ноды Setup, Planner, Cameras, Sampler, Decode), тогда как в старых заметках может встречаться прежняя терминология workflowmode.
Нужна ли мощная видеокарта с большим объёмом VRAM?Нет — слабые видеокарты — это явно поддерживаемый сценарий: стриминг запросов для fused-QKV-нагрузок, которые не помещаются в память, изоляция памяти между повторными запусками, защищённая предзагрузка INT8 VBAR и pinned host memory с учётом давления на RAM.
Что конкретно можно генерировать с этими нодами?Длинное видео со звуковой дорожкой: один непрерывный фильм, разбитый на внутренние блоки фиксированной длительности ради VRAM и стабильности, либо последовательности MultiClip, где Planner управляет промптами сцен, длительностями, названиями и сидами, а нода Cameras отвечает за кадрирование, объектив, движение камеры и переходы. Loop Closure подтягивает сгенерированный хвост обратно к стартовому макросостоянию.
Как работает режим lip-sync с заменой персонажа?В режимах videorefedit потоки Video1 и Audio1 могут выступать как парный референс исходного выступления, при этом Audio1 по-прежнему управляет целевым таймингом и выходной звуковой дорожкой. В режиме lipsync Audio1 намеренно не зависит от исходной мимики, поэтому полностью новые реплики или пение могут управлять замещённым персонажем.
Что делает двухэтапное сэмплирование Latent Hi-Res?Long Media Sampler сначала делает денойз низкоразрешённого Stage-1 x0, обученным апскейлом увеличивает видеолатент, сохраняя аудиолатент, заново строит кондиционирование по целевой сетке и опционально может запустить независимый высокоразрешённый проход со свежим шумом и тем же сидом; без этого Refiner остаётся хвостом с нулевым шумом и низким sigma.
Есть ли готовый воркфлоу, с которого можно начать?Да — в релизы входят примеры JSON-воркфлоу, например 'MiniMax-H3-LongMedia-SAFE-1080p-15s.json' (отправная точка для продакшена) и 'MiniMax-H3-LongMedia-LatentUpscale-Detailer.json', содержащие нейтральные заглушки для медиафайлов вместо пользовательских медиа или локальных путей к превью.
Creator
vizart-vj
Size
6.9 MB
Stars
297
Age
2mo
Commits · 90 Days