MiniMax H3 LongForge 7.2 · FL2VA & REF2VA

От первой сцены до готового фильма со звуком — в одном workflow ComfyUI.

From the first scene to a finished film with audio — in one ComfyUI workflow.

Подписка и поддержка / Follow & support

AI Bob Public · AI DEV LAB

Поддержать разработку можно кнопкой Tip в моём профиле Civitai или добровольным переводом USDT (или другой валютой в соответствующей сети). / Support development through Tip on my Civitai profile or an optional USDT donation (or another currency in the corresponding network).

BNB Smart Chain — 0xdCf9846A1B0F2fe32E19dC9CFdDC5194CC13D108

TON — UQCeukjBulZw9gni1jv8NLRgtmgHDQ6mUiS2qf3716XobIxA

TRON / TRC20 — THLU3yu8VpoPqP4bMLCp86FRhoCweJ2Qz4

Выбирайте сеть, соответствующую адресу и отправляемой валюте. Спасибо за поддержку! / Use the network matching the address and the currency you send. Thank you for your support!

Русский

LongForge собирает длинные видео MiniMax H3 по сценам: от идеи и промптов до фильма со звуком, выбранными тейками, монтажом и HQ. В комплекте — собственный Node Pack, основной workflow FL2VA / REF2VA и RefMod Studio. Управление на английском, подробные инструкции RU/EN встроены в оба workflow.

Главное в 7.2

🌙 Export when done — генерация и готовый экспорт за один запуск.

Включите Export when done в 10 · Project & Scenes, выберите GENERATE NEXT → ALL PENDING и нажмите Run. Сцены сохраняются по одной, а после завершения очереди фильм автоматически собирается с текущими настройками экспорта. Имя файла содержит дату UTC и уникальный суффикс — прошлые экспорты сохраняются. По умолчанию переключатель выключен; он также работает с REGENERATE SELECTED / VARY SELECTED в ALL PENDING.

Если сцена падает или вы останавливаете генерацию, уже готовые сцены остаются, экспорт не начинается. Повтор той же незавершённой очереди продолжает её с сохранённого места, сохраняя seed, в том числе после перезапуска ComfyUI. Если ошибка произошла при экспорте, повторяется только экспорт, без перегенерации сцен и загрузки модели генерации. Его настройки перед повтором можно исправить. Изменение модели, карточек или настроек генерации может начать новую очередь.

В ONE SCENE автоэкспорт ждёт последней карточки. Повторный Run уже готового фильма с включённым Export when done создаёт ещё один экспорт.

📋 Run report — результат ночного запуска в одном окне.

Кнопка Run report в Project & Scenes показывает время каждой сцены, повторы кеша, наблюдения VEDA, предупреждения, ошибки попыток и путь к готовому файлу. Отчёт сохраняется в проекте и доступен после перезапуска. Остановка пользователем отмечается как остановка, а не как ошибка генерации.

🔁 Loop export — циклические ролики для обоев и повторного воспроизведения.

В 19 · Export Settings → Loop export (experimental) доступны:

OFF — обычный экспорт, значение по умолчанию.
CROSSFADE — конец плавно смешивается с началом. При сильно разных кадрах может быть заметен двойной образ.
BEST MATCH — ищет два похожих момента и строит цикл между ними. Может убрать начало и конец, но сохраняет не меньше половины ролика после перехода. Дополнительное декодирование для поиска; ролики до 120 секунд.
PING-PONG — воспроизведение вперёд и назад без дублирования крайних кадров. Без смешивания изображений, но движение заметно разворачивается; длительность почти удваивается. Ролики до 60 секунд, обратная часть временно хранится на диске.

Loop transition задаёт переход CROSSFADE / BEST MATCH: 0,1–5 секунд, с округлением до кадров 24 FPS. Фильм должен быть длиннее удвоенного перехода. В PING-PONG эта настройка не используется.

Loop audio → CROSSFADE сохраняет звук на цикле: с компенсацией громкости перехода, а в PING-PONG — с синхронной обратной частью. MUTE оставляет беззвучную дорожку, удобную для обоев, речи и музыки, которую не нужно разворачивать.

Loop применяется только при экспорте, после Trim и удаления padding импорта: тейки, превью и контекст продолжения сохраняются. Краевые Fade film edges отключаются автоматически; RIFE/FILM обрабатывает и замыкание цикла. Если замыкание попадает точно на монтажный срез, измените переход или Trim. Функция экспериментальная: похожие кадры и crossfade не гарантируют незаметного перехода для любого сюжета.

Исправления 7.2. Улучшены отчёты и продолжение прерванных очередей, повтор экспорта без генерации и восстановление настроек. Исправлены обработка BEST MATCH вместе с Trim, синхронизация звука PING-PONG и инструкции сохранения Curve preset в RefMod Studio. Миниатюры, ручной BLOCK и возможности прежних версий сохранены.

Установка и первый запуск

Закройте ComfyUI и установите или целиком замените ComfyUI/custom_nodes/ComfyUI-H3-LongForge-NodePack/. Сохраните резервную копию проектов из output/longforge_native/.
Установите requirements.txt через Python самого ComfyUI. Для полного шаблона отдельно нужны ComfyUI-KJNodes и Veda-on-ComfyUI с зависимостями. Внешний T8 и оригинальный RefMod-пак не нужны; команды и ссылки — ниже.
Перезапустите ComfyUI, нажмите Ctrl+F5, откройте H3_LongForge_FL2VA_REF2VA_v7.2.json. В 01–04 выберите H3 checkpoint, соответствующий текстовый энкодер и оба VAE; в 11 — подходящий модели FL2VA / REF2VA.
Без совместимого SageAttention обойдите 05–06 через Ctrl+B. VEDA (08a) и Live Preview (04a) отключаются независимо. Bypass не устанавливает отсутствующие типы нод. 09 · Native Cache в шаблоне выключен: для кеширования включите ноду через Ctrl+B и выберите метод.
В 10 · Project & Scenes задайте уникальное имя проекта и промпты. GENERATE NEXT → ONE SCENE / ALL PENDING → Run создаёт одну или все ожидающие сцены, сохраняя каждую.
Для ночного запуска включите Export when done. Для ручной сборки готового фильма выберите EXPORT FILM → Run. Результат: output/longforge_native/<project>/exports/.

Шаблон начинает с 20 шагов и выключенной Turbo LoRA. Для Turbo включите подходящую LoRA в 07 и используйте её рекомендованные настройки. VEDA не уменьшает число шагов и не заменяет Turbo.

Сцены, монтаж и продолжение

Миниатюры. Карточки показывают первый видимый кадр сохранённого тейка; он обновляется после пересъёмки, смены проекта и восстановления цепочки. Если старого превью нет или Scene previews выключены, создайте его через Preview scene. Trim миниатюру не меняет; изображения не встраиваются в workflow.

Продолжение. В 11 · Video & Continuity: PROTECTED копирует видеолатентный хвост с защитной маской, GUIDE использует хвост как ориентир, LAST FRAME передаёт последний декодированный RGB-кадр базового видео. Звук независим: HARD / SOFT / OFF защищают аудиопрефикс, допускают изменение его конца или отключают защищённый контекст, сохраняя генерацию звука. Старт — MANUAL / 22F / HARD; в LAST FRAME 22F задаёт скрытый контекст, а не 22 изображения. Точное сохранение лица и незаметные стыки не гарантируются.

Длительность. WINDOW FRAMES включает overlap, NEW SECONDS задаёт новую видимую часть. Действует сетка H3; у первой сцены предыдущего overlap нет. ALL PENDING проверяется заранее, но AUTO зависит и от будущих сцен, поэтому остановка между сценами возможна.

Обрезать без перегенерации: Preview scene → Trim for export → Set In / Set Out → Apply trim. Можно ввести First / Last frame: нумерация с 1, обе границы включены. Экспорт синхронно обрезает видео и звук, сохраняя полные тейки и контекст продолжения; Reset trim возвращает полный диапазон. Обрезки привязаны к тейкам, новый тейк начинает с полного диапазона.

Продолжить от другой точки: только LAST FRAME — Preview scene → Continue here → проверить следующую карточку → GENERATE NEXT → Run. Точка округляется назад к границе H3; слишком ранняя отклоняется. Создаётся сокращённый тейк видео/HQ/звука, исходная цепочка сохраняется.

Стыки и A/B: Seam Lab сравнивает тейки в фильме из двух и более сцен. Выбор другого тейка делает поздние сцены pending, сохраняя прежнюю цепочку в Saved chains. Trim сам по себе не создаёт плавный переход, интерполяция не заполняет вырезанные интервалы.

Проекты: Open project / Saved chains открывают сохранённые проекты и цепочки, Recover project восстанавливает указатель по проверенным файлам. New film сбрасывает активный фильм, сохраняя обычные карточки и тейки; импортированная карточка становится пустой. Delete all оставляет Scene 1 и файлы, Clean unused очищает неиспользуемое с отдельным подтверждением удаления цепочек, Delete film удаляет папку проекта. Перед пересъёмкой середины есть предупреждение о поздних сценах; GENERATE NEXT на завершённом фильме их не переснимает.

Кеш, ассистент и референсы

09 · Native Cache → OFF / OUTPUT / BLOCK. OFF передаёт модель без кеша. OUTPUT может повторно использовать полный выход модели с независимыми проверками видео и звука: от 16 шагов, CFG 1, Turbo и VEDA в bypass. BLOCK на основе T8 считает первый блок и при малой разнице использует сохранённые изменения остальных: от 4 шагов, CFG 1, Euler / RES multistep / RES multistep CFG++. Turbo допускается; BLOCK + VEDA требует отдельного разрешения.

BLOCK полностью ручной, без пресетов; профили OUTPUT сохранены. Оба метода проходят проверки LongForge Render: другой кеш, несовместимые патчи и RefMod step curves могут отключить кеширование. OUTPUT также отключается со стохастическими семплерами и неизвестным состоянием Turbo. Ускоряющие LoRA подключайте через 07, обычные — через 08 · Extra LoRA. Кеш очищается после каждой сцены, включая ошибку. Старые workflow 7.0 сохраняют OUTPUT; прежние пресеты BLOCK 7.1 переводятся в числовые настройки, CUSTOM сохраняет введённые значения.

active True · reused 0/N означает: кеш включён, но повторов не было. На коротком расписании ускорения может не быть. BLOCK и BLOCK + VEDA экспериментальные; сравнивайте одинаковый seed с OFF и отдельной VEDA. Значения BLOCK — ниже.

Scenario from description / Generate draft. Сценарий на 1–16 новых сцен по идее и общей длительности либо промпт одной сцены с 1–8 шотами. В 16: NATIVE / TRANSFORMERS / GGUF / OLLAMA / SERVER. NATIVE требует отдельную генеративную LLM в 16a, а не энкодер H3; локальные модели и vision-проекции — в models/llm/. Совместимая vision-модель использует выбранные изображения и хвост предыдущей сцены, без анализа аудио. Ассистент сообщает об исправлениях и повторяет отклонённые карточки. До Apply карточки не заменяются; обычный Run фильма не запускает LLM.

IMPORT VIDEO. В пустом проекте 18 · Source Video → IMPORT VIDEO превращает источник в Scene 1; продолжение пишите в Scene 2. Есть CONTAIN / CROP и нормализация к 24 FPS/сетке H3. Используются оба VAE, без diffusion и текстового энкодера. Это VAE-реконструкция, не исходные пиксели 1:1; импортированная Scene 1 не переснимается обычной генерацией. Фото-, видео- и аудиореференсы поддерживают обрезки, режимы звука и пресеты без исходных файлов. Roles, Character group и Keep/Drop помогают ассистенту, напрямую тензоры H3 не меняют.

RefMod Studio. Сохраняет image/video/audio VAE-латенты в .safetensors, без обучения и LoRA; применяется в REF2VA. FULL / COMPRESSED — латенты выбранного разрешения либо экономия токенов ценой деталей. INDEPENDENT / STACK / MERGE — отдельные members, соединение по времени либо общий сжатый референс; MERGE требует COMPRESSED и может смешивать внешность и фон. Есть mixed bundles, маски, превью, token reports, перепаковка, strengths, кривые и A/B. RefMods стартуют выключенными; для сцены — INHERIT / OFF / CUSTOM. Меньшая strength токены не уменьшает; кривые не задают появление персонажа по секундам фильма.

Создание: RefMod_Studio_v7.2.json → источники и VAE → CREATE → Run Studio action → Run, затем выключите переключатель. Просмотр: INSPECT → stored → preview_index, с 0; чёрный квадрат после CREATE — заполнитель. Файлы обычно в models/refmods/longforge/. {refmod:hero} выбирает members файла, {refmod:hero_1} — отдельный выбранный member; Check mapping показывает метки. Для PNG-пресета кривой: CURVE GRAPH, имя в File name, переключатель Curve preset включён.

VEDA, превью, HQ и экспорт

VEDA · 08a: predictor под FL2VA / REF2VA; файлы — ниже. В шаблоне 32 / 32, пустые full-attention lists, verbose = false: 32 — бюджет key tiles по 128 токенов, не 32%. Для сравнения обойдите VEDA через Ctrl+B. Не совмещайте с ComfyUI Model Sparse Attention.

Live Preview · 04a: приблизительная картинка во время семплирования, по умолчанию один кадр без звука. Совместимый H3 tiny VAE — в models/vae_approx/; без него действуют настройки превью ComfyUI. Анимация и звук добавляют расходы. Основной H3 Video VAE не подключайте к LTX-входу vae ноды KJ. Preview scene отдельно декодирует сохранённый тейк.

HQ Finish · 13: OFF / UPSCALE / UPSCALE + REFINE, FULL / TILED / AUTO, пространственные плитки, временные окна и бюджет памяти. Нужен совместимый 3D latent upscaler. Exact width/height задаются парой, кратны 32, сохраняют пропорции и не уменьшают оси; оба 0 используют Scale. Настройки фиксируются внутри фильма. Продолжение использует базовые AV-латенты; HQ-refiner работает без VEDA/Turbo. AUTO не исключает OOM.

Экспорт · 19–20: MP4 / MKV / WEBM, совместимые H264 / HEVC / AV1 / VP9, CPU и доступные аппаратные энкодеры; AUTO с возвратом к CPU. RIFE / FILM работают на финальном экспорте: ×2 → 48 FPS, ×4 → 96 FPS, сохраняя длительность и звук. Есть непрерывное декодирование звука, исправление щелчков и Diagnostic WAVs. На резких переходах возможны артефакты; 10 bit не создаёт HDR из RGB8.

NONE / RECOVERY — без вложенных настроек либо с данными восстановления, включая монтажную карту. Для переноса и резервной копии сохраняйте всю папку проекта, включая локальные обрезки: RECOVERY не заменяет её.

English

LongForge builds long MiniMax H3 videos scene by scene: from an idea and prompts to a film with audio, selected takes, editing and HQ. Includes a custom Node Pack, the FL2VA / REF2VA main workflow and RefMod Studio. Controls use English labels; both workflows include detailed RU/EN guides.

New in 7.2

🌙 Export when done — generate and export in one run.

Enable Export when done in 10 · Project & Scenes, select GENERATE NEXT → ALL PENDING and press Run. Each scene is saved as it finishes; once the queue completes, the film is exported with the current settings. UTC timestamps and unique suffixes preserve previous exports. The toggle defaults to OFF and also works with REGENERATE SELECTED / VARY SELECTED in ALL PENDING.

A failed scene or a user stop during generation keeps completed scenes and prevents export. Repeating the same unfinished batch resumes from its checkpoint with the original seed sequence, even after restarting ComfyUI. After an export failure, only export is retried, without regenerating scenes or loading the generation model; export settings can be corrected first. Changing the model, cards or generation settings may start a new batch.

In ONE SCENE, automatic export waits for the final card. Running an already completed film with Export when done enabled creates another export.

📋 Run report — an overnight run at a glance.

The Run report button in Project & Scenes shows scene timings, cache reuses, VEDA observations, warnings, attempt errors and the output path. Reports persist with the project and remain accessible after restarting. User stops are reported as stops rather than generation errors.

🔁 Loop export — cycles for wallpaper and repeated playback.

19 · Export Settings → Loop export (experimental) offers:

OFF — regular export, the default.
CROSSFADE — blends the ending into the opening. Different images may produce a visible double image.
BEST MATCH — searches for two similar moments and loops between them. May trim the opening and ending but retains at least half the clip after the transition. Requires an extra decode for the search; clips up to 120 seconds.
PING-PONG — forward and backward playback without duplicated turn frames. No image blending, but motion visibly reverses and duration nearly doubles. Clips up to 60 seconds; the reverse half is temporarily stored on disk.

Loop transition sets the CROSSFADE / BEST MATCH window: 0.1–5 seconds, rounded to whole 24 FPS frames. The film must be longer than twice the window. PING-PONG does not use this control.

Loop audio → CROSSFADE retains sound on the cycle, with loudness compensation through the transition; PING-PONG reverses audio in sync with video. MUTE keeps a silent track, useful for wallpaper or speech/music that should not be reversed.

Looping is export only, after Trim and import-padding removal: takes, previews and continuation context are preserved. Film-edge fades turn off automatically; RIFE/FILM also processes the wrap. If the wrap falls exactly on an edited cut, change the window or Trim. This is experimental: similar frames and crossfading cannot guarantee an invisible join for every scene.

7.2 fixes. Improved reports, interrupted-batch resume, export-only retries and settings recovery. Corrected BEST MATCH with Trim, PING-PONG audio alignment and the Curve preset instructions in RefMod Studio. Thumbnails, manual BLOCK controls and earlier features remain available.

Installation and your first run

Stop ComfyUI and install or replace the whole ComfyUI/custom_nodes/ComfyUI-H3-LongForge-NodePack/ folder. Back up projects from output/longforge_native/.
Install requirements.txt with ComfyUI's Python. The complete template also needs ComfyUI-KJNodes and Veda-on-ComfyUI, including dependencies. Separate T8 and original RefMod installations are unnecessary; commands and links are below.
Restart, refresh with Ctrl+F5, then open H3_LongForge_FL2VA_REF2VA_v7.2.json. Select the H3 checkpoint, matching text encoder and both VAEs in 01–04; match FL2VA / REF2VA in 11 to the model.
Bypass 05–06 with Ctrl+B without compatible SageAttention. VEDA (08a) and Live Preview (04a) can be bypassed independently. Bypass does not install missing node types. 09 · Native Cache starts bypassed: enable the node with Ctrl+B and select a method to use caching.
Set a unique project name and prompts in 10 · Project & Scenes. GENERATE NEXT → ONE SCENE / ALL PENDING → Run creates one or all pending scenes, saving each.
Enable Export when done for unattended runs, or select EXPORT FILM → Run to assemble a saved film manually. Output: output/longforge_native/<project>/exports/.

The template starts with 20 steps and Turbo LoRA bypassed. Enable a compatible LoRA in 07 and follow its recommended settings for Turbo. VEDA does not reduce the step count or replace Turbo.

Scenes, editing and continuation

Thumbnails. Cards show the saved take's first visible frame and update after regeneration, project changes and chain restoration. If an older preview is missing or Scene previews are disabled, create one with Preview scene. Trim does not change thumbnails; images are not embedded in workflows.

Continuation. 11 · Video & Continuity offers PROTECTED — copied video-latent tail with a protective mask; GUIDE — tail guidance; LAST FRAME — one final decoded RGB frame from the base video. Independent audio HARD / SOFT / OFF protects the audio prefix, allows its ending to change or disables protected context while retaining sound generation. Starts: MANUAL / 22F / HARD; in LAST FRAME, 22F defines hidden context, not 22 input images. Exact identity and invisible joins are not guaranteed.

Duration. WINDOW FRAMES includes overlap; NEW SECONDS targets the new visible portion. H3-grid rounding applies; Scene 1 has no preceding overlap. ALL PENDING checks ahead, but AUTO depends on future scenes too, so a stop between scenes remains possible.

Trim without regeneration: Preview scene → Trim for export → Set In / Set Out → Apply trim. First / Last frame can be entered directly, starting at 1 with both endpoints included. Export trims video/audio together while preserving full takes and continuation context; Reset trim restores the full range. Edits belong to takes; new takes start full length.

Continue from another point: LAST FRAME only — Preview scene → Continue here → review the next card → GENERATE NEXT → Run. The point snaps backward to an H3 boundary; excessively early points are refused. This creates a shortened video/HQ/audio take while preserving the original chain.

Joins and A/B: Seam Lab compares takes in films with two or more scenes. Selecting another take makes later scenes pending and retains the previous chain in Saved chains. Trimming alone does not create a smooth transition; interpolation does not fill removed intervals.

Projects. Open project / Saved chains opens saved projects and chains; Recover project rebuilds the pointer from verified files. New film resets the active film while keeping ordinary cards and takes; imported cards become blank. Delete all leaves Scene 1 and the files. Clean unused removes unused files with separate confirmation for saved chains; Delete film removes the project folder. Regenerating the middle warns about later scenes; GENERATE NEXT on a completed film does not regenerate them.

Cache, assistant and references

09 · Native Cache → OFF / OUTPUT / BLOCK. OFF passes the model through without caching. OUTPUT can reuse the full model output with independent video/audio checks: at least 16 steps, CFG 1, Turbo and VEDA bypassed. BLOCK, adapted from T8, computes the first block and reuses cached changes from the remaining blocks when differences are small enough: at least 4 steps, CFG 1, Euler / RES multistep / RES multistep CFG++. Turbo is allowed; BLOCK + VEDA needs explicit permission.

BLOCK is fully manual without presets; OUTPUT profiles remain. Both use LongForge Render preflight: another cache, incompatible patches or RefMod step curves may disable caching. OUTPUT also rejects stochastic samplers and unknown Turbo state. Connect accelerating LoRAs through 07, ordinary LoRAs through 08 · Extra LoRA. Cache is cleared after every scene, including on error. Older 7.0 workflows retain OUTPUT; previous 7.1 BLOCK presets migrate to numeric settings, while CUSTOM retains entered values.

active True · reused 0/N means caching was enabled but reused nothing. Short schedules may yield no speed gain. BLOCK and BLOCK + VEDA are experimental; compare the same seed against OFF and VEDA alone. BLOCK values are below.

Scenario from description / Generate draft. Plan 1–16 new scenes from an idea and total duration, or draft one scene with 1–8 shots. 16 supports NATIVE / TRANSFORMERS / GGUF / OLLAMA / SERVER. NATIVE requires a separate generation-capable LLM in 16a, not H3's encoder; local models and vision projections belong in models/llm/. Compatible vision models use selected images and the previous scene tail without analyzing audio. The assistant reports repairs and retries rejected cards. Cards stay unchanged until Apply; normal film generation does not invoke an LLM.

IMPORT VIDEO. In an empty project, 18 · Source Video → IMPORT VIDEO makes the source Scene 1; continue in Scene 2. Includes CONTAIN / CROP and normalization to 24 FPS/the H3 grid. Uses both VAEs without diffusion or the text encoder. This is VAE reconstruction, not original pixels 1:1; imported Scene 1 cannot be remade through ordinary generation. Image/video/audio references support trimming, audio modes and presets without source files. Roles, Character group and Keep/Drop guide the assistant without directly changing H3 tensors.

RefMod Studio. Saves image/video/audio VAE latents in .safetensors, without training or LoRAs; used in REF2VA. FULL / COMPRESSED stores selected-resolution latents or saves tokens at the cost of detail. INDEPENDENT / STACK / MERGE means separate members, temporal stacking or a combined compressed reference; MERGE requires COMPRESSED and may blend appearance/backgrounds. Includes mixed bundles, masks, previews, token reports, repacking, strengths, curves and A/B. RefMods start disabled, with per-scene INHERIT / OFF / CUSTOM. Lower strength does not reduce tokens; curves do not schedule a character's appearance in film seconds.

Create: RefMod_Studio_v7.2.json → sources and VAEs → CREATE → Run Studio action → Run, then disable the switch. Inspect with INSPECT → stored → preview_index, starting at 0; the black image after CREATE is a placeholder. Files normally save in models/refmods/longforge/. {refmod:hero} selects file members; {refmod:hero_1} selects an individual chosen member; Check mapping shows labels. To save a curve PNG preset: CURVE GRAPH, enter File name and enable Curve preset.

VEDA, preview, HQ and export

VEDA · 08a: match the predictor to FL2VA / REF2VA; files are below. Template settings: 32 / 32, empty full-attention lists, verbose = false. 32 is a budget of 128-token key tiles, not 32%. Bypass with Ctrl+B for comparison. Do not combine with ComfyUI Model Sparse Attention.

Live Preview · 04a: approximate sampling progress, defaulting to one frame without sound. A compatible H3 tiny VAE belongs in models/vae_approx/; without one, ComfyUI's preview settings apply. Animation/audio add work. Do not connect the main H3 Video VAE to the KJ node's LTX vae input. Preview scene separately decodes a saved take.

HQ Finish · 13: OFF / UPSCALE / UPSCALE + REFINE, FULL / TILED / AUTO, spatial tiles, temporal windows and a memory budget. Requires a compatible 3D latent upscaler. Exact width/height must be set together, be multiples of 32, preserve aspect ratio and never shrink either axis; both 0 use Scale. Settings stay fixed within a film. Continuation uses base AV latents; the HQ-refiner branch excludes VEDA/Turbo. AUTO does not eliminate OOM.

Export · 19–20: MP4 / MKV / WEBM, compatible H264 / HEVC / AV1 / VP9 combinations, CPU or available hardware encoders; AUTO with CPU fallback. RIFE / FILM run at final export: ×2 → 48 FPS, ×4 → 96 FPS, preserving duration and audio. Includes continuous audio decoding, click repair and Diagnostic WAVs. Hard cuts may produce artifacts; 10 bit does not create HDR from RGB8.

NONE / RECOVERY exports without embedded settings or with recovery data, including the edit map. Keep the whole project folder, including local trims, for transfer and backup: RECOVERY does not replace it.

Настройки BLOCK / BLOCK settings

Threshold — 0.12 (по умолчанию / default). 0–1; выше — агрессивнее / higher is more aggressive.

Window start / end — 0.08 / 0.95 (по умолчанию / default). 0–1, start < end.

Max reuses — 2 (по умолчанию / default). 0–10; 0 отключает повтор / 0 disables reuse.

Storage — cpu (по умолчанию / default). cpu / gpu — RAM / compute device.

Metric stride — 8 (по умолчанию / default). Целое / integer 1–32.

Console report — true (по умолчанию / default). true / false.

BLOCK + VEDA (experimental) — false (по умолчанию / default). true / false.

RU: Storage задаёт место хранения кеша, а не устройство генерации. Metric stride задаёт выборку внутренних данных для оценки разницы: 1 — все значения, 8 — примерно 1/64; это не интервал шагов генерации. Console report включает подробные логи.

EN: Storage chooses where cached tensors live, without changing the generation device. Metric stride samples internal values for difference measurement: 1 checks all values, 8 checks about 1/64; it is not a denoising-step interval. Console report enables detailed logs.

Комплект и зависимости / Package & dependencies

ComfyUI-H3-LongForge-NodePack/
H3_LongForge_FL2VA_REF2VA_v7.2.json
RefMod_Studio_v7.2.json

RU: нужны ComfyUI с нативным MiniMax H3 и V3 node API, соответствующие H3 checkpoint и текстовый энкодер, H3 Video/Audio VAE, FFmpeg с libx264/AAC. Сначала проверяется PATH, затем используется imageio-ffmpeg. Веса и код внешних нод в архив не входят. SageAttention, VEDA, LLM, HQ и интерполяция требуют своих совместимых зависимостей и весов. Node Pack и workflow используйте одной версии 7.2.

EN: requires ComfyUI with native MiniMax H3 and V3 node API, matching H3 checkpoint and text encoder, H3 Video/Audio VAEs, and FFmpeg with libx264/AAC. PATH is checked first, then imageio-ffmpeg. Weights and external-node source are not bundled. SageAttention, VEDA, LLM, HQ and interpolation need compatible dependencies and weights. Use the 7.2 Node Pack and workflows together.

Windows Portable — из корня portable-сборки / from the portable root:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-H3-LongForge-NodePack\requirements.txt

Обычная установка / Standard installation — в окружении ComfyUI, из папки ComfyUI / in ComfyUI's environment, from its directory:

python -m pip install -r custom_nodes/ComfyUI-H3-LongForge-NodePack/requirements.txt

VEDA predictors

Файлы в ComfyUI/models/veda/, выбор в 08a. Требования к GPU/backend и установке — в README VEDA. / Place files in ComfyUI/models/veda/ and select in 08a. See VEDA's README for installation and GPU/backend requirements.

FL2VA — minimax_h3_t2va_veda_8nfe_600step_preview_fp8.safetensors

REF2VA — minimax_h3_r2va_veda_preview_fp8.safetensors

SERVER API

RU: ключ задаётся через LONGFORGE_LLM_API_KEY, без сохранения в workflow. Для внешнего API с ключом укажите LONGFORGE_LLM_API_HOSTS=api.example.com: точные хосты без протокола и пути, несколько — через запятую; поддомены разрешаются отдельно. Внешнему серверу ключ передаётся только по HTTPS. Loopback и серверы без ключа списка не требуют. В Windows .bat добавьте set LONGFORGE_LLM_API_HOSTS=api.example.com перед запуском ComfyUI.

EN: set the key through LONGFORGE_LLM_API_KEY, never a saved workflow field. For a keyed external API, set LONGFORGE_LLM_API_HOSTS=api.example.com: exact hostnames without protocol or path, comma-separated; allow subdomains separately. External keys are sent only over HTTPS. Loopback and keyless servers need no allowlist. In a Windows .bat, add set LONGFORGE_LLM_API_HOSTS=api.example.com before starting ComfyUI.

Ссылки / Links

Проверка / Validation

RU: финальная 7.2 проверена с ComfyUI 0.42.5, frontend 1.55.18, Python 3.12.14 и PyTorch 2.14.1 CPU: 865 Python-тестов, 81 JavaScript-тест, 400 сценариев очередей и браузерные/интеграционные проверки — без провалов. Отдельно прошли 44 проверки автоэкспорта, loop и перезапуска. Три Windows junction-теста пропущены. Настоящие ComfyUI, HTTP/executor, Chromium и FFmpeg работали с CPU-двойниками основных моделей; отдельные проверки кеша использовали небольшой H3 со случайными весами.

EN: final 7.2 was checked with ComfyUI 0.42.5, frontend 1.55.18, Python 3.12.14 and PyTorch 2.14.1 CPU: 865 Python tests, 81 JavaScript tests, 400 queue scenarios and browser/integration checks, without failures. This includes 44 automatic-export, loop and restart checks. Three Windows junction tests were skipped. Real ComfyUI, HTTP/executor, Chromium and FFmpeg ran with CPU doubles of the main models; dedicated cache checks used a small randomly initialized H3.

RU: обученные модели, GPU-генерация, GPU-ядра VEDA, скорость/VRAM, аппаратные энкодеры и Windows здесь не проверялись. BLOCK, BLOCK + VEDA и loop экспериментальные. Результаты тестов не гарантируют отсутствие ошибок или одинаковое качество на любой системе. Архив верификации и ревью поставляются отдельно от чистого релиза.

EN: trained models, GPU generation, VEDA GPU kernels, speed/VRAM, hardware encoders and Windows were not tested here. BLOCK, BLOCK + VEDA and looping are experimental. Passing tests does not guarantee an error-free build or identical quality on every system. Verification and review are separate from the clean release.

Авторы и благодарности / Credits

BLOCK cache: адаптация / adapted from comfyui-minimax-h3-blockcache-T8 — T8mars, Apache-2.0. Отдельная установка не нужна / no separate installation required.
OUTPUT cache / LAST FRAME: подходы изучены на примере / approaches studied through comfyui-AGSoft — AGSoft, с собственной интеграцией в систему сцен LongForge / with LongForge's own scene-system integration.
RefMod: адаптация / adapted from ComfyUI-MiniMaxH3Mod — Luisa / Luisacaotica.
HQ: адаптация апскейлера / upscaler adaptation — LBH-123-AI.
VEDA: veda-sparse / Veda-on-ComfyUI. Live Preview & attention tools: Kijai / ComfyUI-KJNodes — внешние подключаемые ноды / external workflow nodes.

Авторские уведомления и сторонние лицензии сохранены в Node Pack. / Third-party credits and licenses are retained in the Node Pack.

Files with SHA256: 8d32ba9d249cd27483e9772c1c4a6f23c35e03a8606e9be60fabc5056d191197