MiniMax H3 LongForge — FL2VA & REF2VA v6.5 (FIX)

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

AI Bob Public · AI DEV LAB

Если LongForge помогает вам, поддержать дальнейшую разработку можно через кнопку Tip в моём профиле Civitai или добровольным переводом USDT.

If LongForge helps you, support future development through the Tip button on my Civitai profile or an optional USDT donation.

BNB Smart Chain: 0xdCf9846A1B0F2fe32E19dC9CFdDC5194CC13D108
TON: UQCeukjBulZw9gni1jv8NLRgtmgHDQ6mUiS2qf3716XobIxA
TRON / TRC20: THLU3yu8VpoPqP4bMLCp86FRhoCweJ2Qz4

Пожалуйста, отправляйте только USDT через соответствующую сеть. Спасибо!

Please send only USDT using the matching network. Thank you!

Русский

Создавайте длинные видео MiniMax H3 со звуком: планируйте историю, генерируйте сцены, продолжайте с нужного момента, выбирайте тейки и собирайте фильм в одном workflow ComfyUI.

В комплекте — собственный Node Pack, главный workflow с поддержкой FL2VA / REF2VA и универсальный RefMod Studio. Названия элементов управления — на английском; инструкции на русском и английском встроены в оба workflow.

v6.5 (FIX) объединяет возможности LongForge 6.5 с накопленными исправлениями и оптимизациями до r12. Scenario from description создаёт карточки сцен из одной идеи, Continue here позволяет продолжить сохранённую сцену с выбранного момента. Доступны три способа продолжения PROTECTED / GUIDE / LAST FRAME, проекты, референсы, HQ и экспорт.

Что исправлено в v6.5 (FIX)

Это обновление на основе 6.5-fixed-r12. Основные возможности v6.5 сохранены; изменения направлены на продолжение HQ-фильмов, проверку очередей, работу с файлами и обработку ошибок.

Продолжение фильмов с HQ. Исправлена повторная нормализация Scale, из-за которой следующая сцена могла получить другой размер и остановиться с ошибкой. Запрошенный масштаб и фактический размер теперь сохраняются согласованно. Например, HQ ×1.5 при базовых 736×416 продолжает фильм в сохранённых 1088×640. Восстановление старых HQ-настроек через Open project и workflow/API согласовано; настоящая смена размера внутри фильма по-прежнему отклоняется до семплирования.
Предпроверка ALL PENDING. До первой генерации проверяются границы очереди: перекрытие, доступный контекст предыдущей сцены, аудиоистория и SOFT-переходы. Многие ошибки настроек выявляются до затрат на генерацию. Для AUTO, где перекрытие зависит от ещё не созданного видео, редкая остановка между сценами остаётся возможной.
Меньше повторного чтения тейков. При обычном GENERATE NEXT неизменённые файлы больше не хешируются целиком при каждом запуске следующей сцены. Экспорт, восстановление и другие операции проверки сохранённых цепочек по-прежнему перечитывают файлы для свежей проверки целостности. Это сокращает дисковые операции на длинных проектах; выигрыш зависит от размера тейков и накопителя.
RefMod: свежая проверка и повторное использование. Перед первой загрузкой файла в новом рендере SHA-256 проверяется заново, включая крупные файлы. Следующие сцены того же рендера используют результат, пока не изменились файловые признаки. Загрузка через Studio выполняет свежую проверку каждый раз.
Быстрее подготовка отдельного стыка в Seam Lab. Для видеопревью выбранного окна декодируются только нужные сцены и их предшественники. В проверенном примере стыка из восьмисценного фильма число видеодекодирований уменьшилось с 8 до 3; кадры окна и отчёт совпали с полным декодированием.
Уточнены ограничения Native Cache. Семплеры seeds_2 и seeds_3, добавляющие шум между шагами, теперь отключают кэш. Существующие ограничения для активной Turbo LoRA, другого кэша и RefMod sampling-step curves сохранены.
Корректная передача ошибок памяти. Ошибки OOM больше не подменяются общим RuntimeError при добавлении контекста сцены: ComfyUI сохраняет возможность распознать нехватку памяти и выполнить свою обработку.
Защита ключа SERVER. Ключ из LONGFORGE_LLM_API_KEY отправляется только на локальный сервер или на явно разрешённые хосты из LONGFORGE_LLM_API_HOSTS. Чужой workflow не может направить этот ключ на произвольный HTTPS-сервер. Для внешнего сервера с ключом нужно указать разрешённое имя хоста; порядок настройки приведён ниже.
Дополнительные исправления. Обновлена проба аппаратных энкодеров для AUTO, исправлен показ видимой длительности импортированного фильма, добавлена очистка старых незавершённых PCM-файлов и уточнены подсказки. Ограничение длины аудио-/видеореференса и поведение затухания звука в этом FIX не менялись.

Основные дополнения v6.5 после v6.1

Сценарий из одного описания. Новый Scenario from description подготавливает 1–16 новых сцен с названиями, действиями, камерой и звуком. Задайте идею и суммарную длительность новых сцен, затем проверьте карточки перед применением.
Редактируемые карточки сценария. Перед Validate & apply можно изменить название, промпт и длительность каждой новой сцены. Сохранённая часть фильма остаётся на месте. Если после сценария есть другие pending-карточки, интерфейс предлагает сохранить их или удалить.
Обновлён сценарист. Улучшены разбор ответов, обработка опечаток в названиях полей, нумерация Shot и локальные временные отметки. Автоматические исправления показываются в отчёте. Повторный запрос исправляет отклонённые карточки и получает принятые соседние сцены как контекст; принятый текст сохраняется.
Короче запросы к ассистенту. Общая идея передаётся один раз, а повтор содержит инструкции для исправляемых карточек. Это уменьшает объём входного текста; фактическая скорость зависит от модели и оборудования.
Продолжение с выбранного момента. Continue here создаёт укороченный тейк из сохранённой сцены и позволяет продолжить фильм от выбранного кадра через LAST FRAME. Для самого сокращения diffusion не запускается; прежняя цепочка остаётся в Saved chains.
Исправлена граница между генерацией и превью. Добавлена очистка состояния DynamicVRAM перед декодированием внутри ноды. Убрана безусловная выгрузка всех моделей перед каждым превью, которая могла вызывать повторную загрузку на следующей сцене. Для ошибки нехватки памяти предусмотрен один повтор декодирования после выгрузки.
Исправлены RefMod sampling-step curves. Устранено падение на inference-тензорах. Кэш размытия теперь учитывает изменение всех значений референса, включая перестановки, без прежнего отпечатка из сумм и нормы.
Доработаны backend ассистента. Изображения сверх лимита vision больше не читаются зря; исправлено освобождение ресурсов GGUF при ошибке загрузки. Усилены проверки адреса SERVER и передачи API-ключа по HTTP.
Обновлены редактор и инструкции. Переработаны подписи и компоновка, уточнены английские имена кнопок в RU-подсказках. Дополнительное поле длительности в главном редакторе убрано: обычные сцены используют настройки Video & Continuity, а карточки сценариста сохраняют свои длительности.

Scenario from description — от идеи к сценам

Настройте 16 · Prompt Assistant. Для NATIVE выберите отдельную генеративную Gemma 4 в 16a · Assistant text model и включите загрузчик. Также доступны TRANSFORMERS / GGUF / OLLAMA / SERVER.
В 10 · Project & Scenes задайте имя проекта и откройте Scenario from description.
Напишите идею, выберите 1–16 новых сцен и их общую длительность. Нажмите Generate scenario.
Просмотрите карточки: название, действие, камера, звук и длительность. Исправьте нужное и нажмите Validate & apply.
Запустите видео отдельно: GENERATE NEXT → Run. ONE SCENE создаёт одну следующую сцену, ALL PENDING — все оставшиеся с сохранением каждой.

Создание сценария не запускает видеогенерацию. До применения черновика карточки фильма не заменяются. Длительности округляются по нативной сетке H3; итоговые значения видны при проверке.

Vision может показать ассистенту доступные изображения первой новой карточки; будущие сцены ещё не существуют. Ассистент не слушает аудио. Сгенерированный сценарий нужно проверить перед запуском фильма.

Continue here — продолжить с нужного кадра

Откройте сохранённый проект и выберите 11 · Video & Continuity → Continuation method → LAST FRAME.
Загрузите Preview scene, остановите видео в нужном месте и нажмите Continue here.
Проверьте показанные кадр и время. Точка округляется назад к допустимой границе H3; слишком ранняя точка может быть отклонена, если не хватает контекста.
Подтвердите создание укороченного тейка, проверьте следующую карточку и используйте GENERATE NEXT → Run.

Базовое видео, HQ и звук сокращаются согласованно в новый тейк. Если выбрана средняя сцена, последующие становятся pending. Исходная версия фильма остаётся в Saved chains; необходимые исходные тейки защищены от очистки, пока используются активным фильмом.

Укороченную таким способом сцену можно продолжать только через LAST FRAME. PROTECTED и GUIDE для неё останавливаются с пояснением. Для продолжения с обычного конца сцены достаточно GENERATE NEXT.

Три способа продолжения видео

МетодЧто используется из предыдущей сценыPROTECTEDВидеолатентный хвост копируется и защищается маской.GUIDEВидеолатентный хвост служит нативным ориентиром. Скрытый контекст генерируется заново, затем исходный префикс восстанавливается перед сохранением.LAST FRAMEОдин последний декодированный RGB-кадр базового видео. H3 кодирует его через Video VAE; готовый видеолатентный хвост в генерацию не передаётся.

Метод выбирается в 11 · Video & Continuity → Continuation method. LAST FRAME появился в v6.1 и сохранён в v6.5. Для первой сцены предыдущего кадра ещё нет, поэтому она генерируется обычным способом.

GUIDE передаёт движение, внешность, цвет и освещение. Ни один способ не гарантирует точного сохранения лица, отсутствия дрейфа или незаметного стыка.

Audio continuity — отдельная настройка:

HARD защищает скопированный аудиопрефикс.
SOFT позволяет переработать его последние 100/200 мс.
OFF отключает защищённый аудиоконтекст, но не выключает генерацию звука.

22F в LAST FRAME не означает передачу 22 картинок. Это скрытый контекст для таймлайна и правил звука. Передаётся одна картинка, скрытое видео генерируется заново, а превью и экспорт удаляют скрытый участок.

Для начала можно использовать MANUAL / 22F / HARD. Обычные референсы и RefMods применяются по своим независимым настройкам.

Основные возможности

Длительность: WINDOW FRAMES задаёт всё окно, включая overlap; NEW SECONDS — желаемую новую видимую часть. H3 округляет число кадров к своей сетке. Например, 158F / 24 FPS ≈ 6,58 с; при overlap 22F новая часть ≈ 5,67 с. У первой сцены предыдущего overlap нет.
Импорт готового видео: 18 · Source Video → IMPORT VIDEO в пустом проекте создаёт Scene 1 для продолжения. Доступны CONTAIN / CROP и нормализация к 24 FPS и сетке H3. Нужны оба VAE; diffusion и текстовый энкодер при импорте не запускаются. Источник проходит VAE-реконструкцию.
Reference media: фото, видео и аудио, Open / trim, Start/End, режимы Audio only / Paired audio / Separate audio / No audio, роли референсов и пресеты. Роли, Character group и Keep/Drop помогают ассистенту писать промпт; сами по себе они не меняют тензоры H3. Пресеты хранят настройки и пути без исходных медиафайлов.
Prompt Assistant для одной сцены: NATIVE / TRANSFORMERS / GGUF / OLLAMA / SERVER, выбранные изображения и хвост предыдущей сцены при подходящей vision-модели, планирование 1–8 шотов внутри сцены. Generate draft → Validate & apply. Обычный Run фильма LLM не запускает. Для NATIVE нужен генеративный Gemma 4, а не H3 conditioning-энкодер.
HQ Finish: OFF / UPSCALE / UPSCALE + REFINE, FULL / TILED / AUTO, пространственные плитки, временные окна и бюджет памяти. Продолжение использует базовую сцену до HQ. AUTO оценивает память, но не исключает OOM.
Экспорт: MP4 / MKV / WEBM, совместимые сочетания H264 / HEVC / AV1 / VP9, CPU и доступные аппаратные энкодеры, AUTO с возвратом к CPU и совместимое H264 MP4-превью. RIFE/FILM-интерполяция применяется на финальном экспорте: ×2 → 48 FPS, ×4 → 96 FPS. 10 bit не создаёт HDR из RGB8; на резких переходах возможны артефакты интерполяции.

Проекты, тейки и защита сцен

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

Seam Lab позволяет просматривать стыки и сравнивать совместимые тейки. Экспорт использует непрерывное декодирование аудио, необязательное исправление щелчков и Diagnostic WAVs.

RefMod Studio и сохранённые референсы

RefMods хранят VAE-латенты изображения, видео или аудио в .safetensors. Это не обучение H3 и не LoRA. Один файл может содержать несколько независимых референсов.

FULL сохраняет кодированный латент при выбранном разрешении; исходные пиксели без потерь не хранятся.
COMPRESSED уменьшает стоимость по токенам ценой деталей; доступно необязательное refinement.
INDEPENDENT / STACK / MERGE: отдельные members, соединение по времени или общий сжатый референс. MERGE требует COMPRESSED и может смешивать позы, лицо и фон.
Создание image/video/audio/mixed bundles, маски, просмотр, отчёты о токенах, перепаковка, сохранённые конфигурации и кривые.
Выбор members, раздельная сила visual/audio, копии и ось A/B. До 8 файлов в библиотеке и до 256 members на файл — структурные пределы; практический объём зависит от токенов и памяти.

{refmod:hero} ссылается на выбранные members файла с alias hero; {refmod:hero_1} и далее — на отдельные выбранные members. Check mapping показывает точные метки. Имя файла не объединяет несколько ракурсов в один референс.

Сохранённые латенты используются без повторного VAE-кодирования источников; визуальные RefMods могут декодироваться для vision/text conditioning. Frame curve действует внутри самого референса, sampling-step curve — по ходу денойзинга. Они не задают секунды появления персонажа в фильме. Малая strength не сокращает число токенов; точность внешности и голоса зависит от результата модели.

RefMods требуют REF2VA, стартуют отключёнными и поддерживают INHERIT / OFF / CUSTOM для каждой сцены. Политики обычных медиа в 11 и RefMods в 17 независимы.

Native Cache и метаданные

Native Cache разрешён только при bypass ноды 07 · Turbo LoRA. Активная 07 отключает кэш независимо от имени LoRA, strength и числа шагов. Ускоряющие LoRA загружайте через 07; 08 · Extra LoRA предназначена для обычных LoRA. Другой активный кэш, RefMod sampling-step curves и семплеры с добавлением шума между шагами, включая seeds_2 / seeds_3, также отключают Native Cache.

NONE / RECOVERY: экспорт без вложенных настроек либо с данными восстановления. RECOVERY не заменяет резервную копию проекта. Ключ SERVER задаётся через LONGFORGE_LLM_API_KEY и в workflow не сохраняется.

SERVER с ключом: для внешнего API дополнительно задайте LONGFORGE_LLM_API_HOSTS=api.example.com, заменив пример на точное имя своего сервера, без https:// и пути. Несколько хостов указываются через запятую; разрешение домена не разрешает его поддомены автоматически. Внешнему серверу ключ передаётся только по HTTPS. Для loopback и серверов без ключа список разрешённых хостов не требуется. В Windows .bat переменная задаётся строкой set LONGFORGE_LLM_API_HOSTS=api.example.com перед командой запуска ComfyUI.

Установка и быстрый старт

Закройте ComfyUI и целиком замените папку ComfyUI/custom_nodes/ComfyUI-H3-LongForge-NodePack/. Сохраните проекты в output/longforge_native/.
Установите requirements.txt нодпака через Python самого ComfyUI. Перезапустите ComfyUI и обновите браузер Ctrl+F5.
Откройте главный workflow, выберите H3 checkpoint, H3 текстовый энкодер и оба VAE. Pipeline должен соответствовать модели.
Задайте уникальное имя проекта. Напишите промпты вручную или подготовьте карточки через Scenario from description.
Выберите способ продолжения и используйте GENERATE NEXT → Run. Для сборки сохранённых сцен — EXPORT FILM → Run.

Результаты: output/longforge_native/<project>/exports/.

Для RefMods откройте Studio, добавьте источники, выберите CREATE, тип, режим и layout, затем включите Run Studio action → Run. После действия выключите переключатель. Файлы обычно сохраняются в models/refmods/longforge/.

Просмотр: INSPECT → stored → preview_index, начиная с 0. Чёрный квадрат 64 × 64 после CREATE — служебный заполнитель. В фильме включите RefMod Library, задайте alias и проверьте метки через Check mapping.

После обновления используйте Node Pack и оба workflow одной версии. Перед работой с важным проектом сохраните резервную копию его папки.

English

Create long MiniMax H3 videos with audio: plan a story, generate scenes, continue from a chosen moment, select takes and assemble the film in one editable ComfyUI workflow.

The package includes a custom Node Pack, a main workflow supporting FL2VA / REF2VA, and a universal RefMod Studio. Controls use English labels; Russian and English instructions are built into both workflows.

v6.5 (FIX) combines the LongForge 6.5 features with accumulated fixes and optimizations through r12. Scenario from description prepares scene cards from one idea, while Continue here lets you continue a saved scene from a selected point. PROTECTED / GUIDE / LAST FRAME, projects, references, HQ and export remain available.

What is fixed in v6.5 (FIX)

This update is based on 6.5-fixed-r12. The main v6.5 features remain available; the changes address HQ film continuation, queue validation, file handling and error reporting.

Continue films with HQ enabled. Fixed repeated Scale normalization that could produce a different delivery size for the next scene and stop the run. Requested scale and actual geometry are now stored consistently. For example, HQ ×1.5 at a base size of 736×416 continues at the saved 1088×640. Restoring legacy HQ settings through Open project and workflow/API is handled consistently; an actual delivery-size change within a film is still rejected before sampling.
ALL PENDING preflight. Before the first scene is generated, queue boundaries are checked for overlap, available previous-scene context, audio history and SOFT transitions. Many configuration errors are caught before generation work begins. AUTO overlap depends on video that has not yet been generated, so a rare stop between scenes remains possible.
Less repeated take-file reading. Ordinary GENERATE NEXT no longer re-hashes every unchanged take in full on each run. Export, recovery and other saved-chain verification operations still read files afresh for integrity checks. This reduces disk work on long projects; the benefit depends on take sizes and storage.
RefMod: fresh verification and reuse. SHA-256 is checked afresh before a file is first loaded in a new render, including large files. Later scenes in that render reuse the result while the file's stat identity is unchanged. Studio loading performs a fresh check every time.
Faster preparation of a selected Seam Lab join. Video decoding is limited to scenes needed for the selected window and their predecessors. In the tested join from an eight-scene film, video decoding calls dropped from 8 to 3; window frames and the join report matched a full decode.
Updated Native Cache guards. The seeds_2 and seeds_3 samplers, which add noise between steps, now disable caching. Existing guards for an active Turbo LoRA, another cache and RefMod sampling-step curves remain in place.
Preserved out-of-memory errors. Adding scene context no longer replaces an OOM exception with a generic RuntimeError, allowing ComfyUI to recognize and handle the original memory error.
SERVER key protection. The key from LONGFORGE_LLM_API_KEY is sent only to a local server or hosts explicitly listed in LONGFORGE_LLM_API_HOSTS. A shared workflow cannot redirect that key to an arbitrary HTTPS server. An external keyed server requires an allowed hostname; setup details are provided below.
Additional fixes. Updated the hardware-encoder probe used by AUTO, corrected visible-duration reporting for imported films, added cleanup of old unfinished PCM files and clarified tooltips. This FIX does not change audio/video reference-length limits or audio fade behaviour.

Main v6.5 additions since v6.1

A scenario from one description. Scenario from description prepares 1–16 new scenes with names, actions, camera directions and sound. Enter an idea and the total duration of the new scenes, then review the cards before applying them.
Editable scenario cards. Change each new scene's name, prompt and duration before Validate & apply. The saved part of the film stays in place. If other pending cards follow the scenario, the interface lets you keep or remove them.
Updated scenario writer. Improved response parsing, field-name typo handling, Shot numbering and local timestamps. Automatic corrections are listed in the report. Retries rewrite rejected cards with accepted neighbouring scenes supplied as context; accepted text is preserved.
Shorter assistant requests. The shared idea is sent once, and targeted retries carry instructions for the cards being corrected. This reduces input text; actual speed depends on the model and hardware.
Continue from a selected point. Continue here creates a shortened take from a saved scene and lets you continue from the selected frame using LAST FRAME. Shortening runs no diffusion; the previous chain remains in Saved chains.
Fixed the sampling-to-preview boundary. DynamicVRAM state is cleaned up before decoding inside the node. Removed unconditional unloading of all models before every preview, which could force another load for the next scene. A decode out-of-memory error allows one retry after unloading.
Fixed RefMod sampling-step curves. Resolved the inference-tensor crash. The blur cache now detects changes across all reference values, including permutations, without the previous sums-and-norm fingerprint.
Assistant backend fixes. Images beyond the vision limit are no longer loaded unnecessarily; GGUF resources are released when model loading fails. SERVER address checks and HTTP API-key handling have been strengthened.
Updated editor and instructions. Revised labels and layout, with exact English control names in Russian notes. Removed the extra duration field from the main editor: ordinary scenes use Video & Continuity, while scenario cards retain their individual durations.

Scenario from description — from an idea to scene cards

Configure 16 · Prompt Assistant. For NATIVE, select a separate generation-capable Gemma 4 in 16a · Assistant text model and enable its loader. TRANSFORMERS / GGUF / OLLAMA / SERVER are also available.
Set a project name in 10 · Project & Scenes, then open Scenario from description.
Enter the idea, choose 1–16 new scenes and their total duration, then click Generate scenario.
Review each card's name, action, camera, sound and duration. Edit as needed and click Validate & apply.
Generate the video separately with GENERATE NEXT → Run. ONE SCENE generates the next scene; ALL PENDING generates all remaining scenes, saving each one.

Scenario generation does not start video generation. Film cards are not replaced until you apply the draft. Durations follow the native H3 grid; validation shows the effective values.

Vision can supply available images for the first new card; future scenes do not exist yet. The assistant does not listen to audio. Review generated scenarios before running the film.

Continue here — continue from a chosen frame

Open a saved project and select 11 · Video & Continuity → Continuation method → LAST FRAME.
Load Preview scene, pause at the desired point and click Continue here.
Check the displayed frame and time. The point snaps backward to a valid H3 boundary; an early point may be rejected if it leaves insufficient context.
Confirm the shortened take, review the next card and use GENERATE NEXT → Run.

Base video, HQ and audio are shortened together into a new take. Later scenes become pending if a middle scene is shortened. The previous film remains in Saved chains; required source takes are protected from cleanup while the active film needs them.

A scene shortened this way can be continued only with LAST FRAME. PROTECTED and GUIDE stop with an explanation. To continue from an ordinary scene endpoint, use GENERATE NEXT directly.

Three video continuation methods

MethodWhat carries over from the preceding scenePROTECTEDThe video-latent tail is copied and protected with a mask.GUIDEThe video-latent tail supplies native guidance. Hidden context is regenerated, then the original prefix is restored before storage.LAST FRAMEOne final decoded RGB frame from the base video. H3 encodes it through the Video VAE; the existing video-latent tail is not transferred into generation.

Choose the method in 11 · Video & Continuity → Continuation method. LAST FRAME was introduced in v6.1 and remains in v6.5. Scene 1 is generated normally because no previous frame exists yet.

GUIDE carries motion, appearance, colour and lighting. No method guarantees exact identity preservation, freedom from drift or invisible joins.

Audio continuity is a separate setting:

HARD protects the copied audio prefix.
SOFT allows its final 100/200 ms to be reworked.
OFF disables protected audio context but does not mute generated sound.

22F in LAST FRAME does not mean 22 reference images. It is hidden context for timeline and audio alignment. One image is supplied, hidden video is generated afresh, and preview/export trim the hidden section.

Start with MANUAL / 22F / HARD if desired. Ordinary references and RefMods follow their own independent settings.

Main features

Duration: WINDOW FRAMES sets the full window, including overlap; NEW SECONDS targets the new visible portion. Native H3 grid rounding applies. For example, 158F / 24 FPS ≈ 6.58 s; with 22F overlap, the new part is ≈ 5.67 s. Scene 1 has no preceding overlap.
Import an existing video: 18 · Source Video → IMPORT VIDEO in an empty project creates Scene 1 for continuation. CONTAIN / CROP and normalization to 24 FPS and the H3 grid are available. Both VAEs are required; import runs neither diffusion nor the text encoder. Source pixels are VAE-reconstructed.
Reference media: images, video and audio, Open / trim, Start/End, Audio only / Paired audio / Separate audio / No audio, reference roles and presets. Roles, Character group and Keep/Drop help the assistant write prompts; they do not directly modify H3 tensors. Presets store settings and paths without embedding source media.
Single-scene Prompt Assistant: NATIVE / TRANSFORMERS / GGUF / OLLAMA / SERVER, selected images and the previous scene tail with a suitable vision model, and 1–8 shots within a scene. Generate draft → Validate & apply. Ordinary film Run does not start an LLM. NATIVE requires a generation-capable Gemma 4, not the H3 conditioning encoder.
HQ Finish: OFF / UPSCALE / UPSCALE + REFINE, FULL / TILED / AUTO, spatial tiles, temporal windows and a memory budget. Continuation uses the base scene before HQ. AUTO estimates memory usage but does not eliminate OOM risk.
Export: MP4 / MKV / WEBM, compatible H264 / HEVC / AV1 / VP9 combinations, CPU and available hardware encoders, AUTO with CPU fallback, and a compatible H264 MP4 preview. RIFE/FILM interpolation runs at final export: ×2 → 48 FPS, ×4 → 96 FPS. The 10-bit option does not create HDR from RGB8; interpolation may introduce artifacts at hard cuts.

Projects, takes and scene protection

GENERATE NEXT on a completed film does not regenerate anything. Add a card or explicitly choose regeneration.
Saved chains restores a saved film version without generating again, including continuations saved just before an interrupted run.
Recover project rebuilds the film pointer from verified files when an intact saved chain is available.
Before regenerating the middle of a film, a warning explains that later scenes will leave the active chain and remain on disk.
Clean unused protects saved chains and continuations; removing them requires separate confirmation.
New film resets the active film and keeps takes; Delete film removes the project. A stale Restore cannot undo a fresh New film action.

Seam Lab inspects joins and compares compatible takes. Export uses continuous audio decoding, optional click repair and Diagnostic WAVs.

RefMod Studio and saved references

RefMods store image, video or audio VAE latents in .safetensors. They do not train H3 weights or a LoRA. One file may contain multiple independent references.

FULL retains the encoded latent at the selected resolution; source pixels are not stored losslessly.
COMPRESSED reduces token cost at the expense of detail, with optional refinement.
INDEPENDENT / STACK / MERGE: separate members, temporal stacking or a combined compressed reference. MERGE requires COMPRESSED and may blend poses, faces and backgrounds.
Image/video/audio/mixed bundles, masks, previews, token reports, repacking, saved configurations and curves.
Member selection, separate visual/audio strengths, copies and the A/B axis. Up to 8 library files and 256 members per file are structural limits; practical capacity depends on tokens and memory.

{refmod:hero} addresses the selected members of a file aliased hero; {refmod:hero_1} and subsequent names address individual selected members. Check mapping shows the exact labels. A file alias does not merge several views into a single reference.

Saved latents are reused without repeating source VAE encoding; visual RefMods may still be decoded for vision/text conditioning. Frame curves act within the reference; sampling-step curves act during denoising. They do not schedule a character's appearance in film seconds. Lower strength does not reduce token count; identity and voice fidelity depend on the model's output.

RefMods require REF2VA, start disabled and support per-scene INHERIT / OFF / CUSTOM selection. Ordinary media policy in 11 and RefMod policy in 17 are independent.

Native Cache and metadata

Native Cache requires 07 · Turbo LoRA to be bypassed. An active node 07 disables caching regardless of filename, strength or step count. Route accelerating LoRAs through 07; 08 · Extra LoRA is for ordinary LoRAs. Another active cache, RefMod sampling-step curves and samplers that add noise between steps, including seeds_2 / seeds_3, also disable Native Cache.

NONE / RECOVERY: export without embedded settings or with recovery data. RECOVERY does not replace a project backup. The SERVER key uses LONGFORGE_LLM_API_KEY and is not stored in the workflow.

SERVER with an API key: for an external API, also set LONGFORGE_LLM_API_HOSTS=api.example.com, replacing the example with your server's exact hostname, without https:// or a path. Separate multiple hosts with commas; listing a domain does not automatically allow its subdomains. A key is sent to an external server only over HTTPS. Loopback and keyless servers do not require this allowlist. In a Windows .bat file, add set LONGFORGE_LLM_API_HOSTS=api.example.com before the ComfyUI launch command.

Installation and quick start

Close ComfyUI and replace the entire folder at ComfyUI/custom_nodes/ComfyUI-H3-LongForge-NodePack/. Keep projects under output/longforge_native/.
Install the node pack's requirements.txt using ComfyUI's Python environment. Restart ComfyUI and refresh the browser with Ctrl+F5.
Open the main workflow, select the H3 checkpoint, H3 text encoder and both VAEs. Match Pipeline to the model.
Enter a unique project name. Write prompts manually or prepare cards with Scenario from description.
Choose a continuation method and use GENERATE NEXT → Run. Assemble saved scenes with EXPORT FILM → Run.

Results: output/longforge_native/<project>/exports/.

For RefMods, open Studio, add sources, choose CREATE, source kind, mode and layout, then enable Run Studio action → Run. Turn the switch off afterwards. Files normally save under models/refmods/longforge/.

Preview saved members with INSPECT → stored → preview_index, starting at 0. The black 64 × 64 image after CREATE is a placeholder. In the film workflow, enable RefMod Library, set an alias and confirm labels with Check mapping.

Use a matching Node Pack and workflow version after updating. Back up important project folders before working on them.

Комплект / Included files

ComfyUI-H3-LongForge-NodePack/
H3_LongForge_FL2VA_REF2VA_v6.5.json
RefMod_Studio_v6.5.json

RU: модели, VAE, LoRA и дополнительные веса скачиваются отдельно.

EN: models, VAEs, LoRAs and additional weights are downloaded separately.

Требования и ссылки / Requirements & links

RU: ComfyUI с нативными MiniMax H3 и V3 node API, соответствующие H3 checkpoint и текстовый энкодер, H3 Video VAE, H3 Audio VAE и рабочий FFmpeg. Attention-ноды главного workflow требуют KJNodes и совместимый SageAttention. Для дополнительных LLM-бэкендов, HQ и интерполяции нужны соответствующие зависимости и веса; инструкции находятся внутри workflow.

EN: ComfyUI with native MiniMax H3 and V3 node API, matching H3 checkpoint and text encoder, H3 Video VAE, H3 Audio VAE and working FFmpeg. The main workflow's attention nodes require KJNodes and compatible SageAttention. Optional LLM backends, HQ and interpolation need their corresponding dependencies and weights; instructions are included in the workflows.

Проверка сборки / Build verification

RU: основа выпуска — 6.5-fixed-r12. По отчёту сборки пройдены 475 Python-, 41 JavaScript-, 15 интеграционных и 66 браузерных проверок, а также 125 проверок синтаксиса и контрольные суммы 183 файлов. Браузерные проверки выполнены автором сборки в Chromium 141 с frontend 1.55.17. Независимо повторены 475 Python- и 41 JavaScript-проверка, проверены контрольные суммы и дополнительные случаи продолжения старых HQ-проектов.

EN: this release is based on 6.5-fixed-r12. The build report records 475 Python, 41 JavaScript, 15 integration and 66 browser checks passed, plus 125 syntax checks and checksums for 183 files. Browser checks were performed by the build author in Chromium 141 with frontend 1.55.17. The 475 Python and 41 JavaScript checks were independently repeated, with checksum verification and additional legacy-HQ continuation cases.

RU — границы проверки: логика проверена на CPU, часть генерации и декодирования — с двойниками моделей. Исправления геометрии HQ дополнительно проверены с настоящим LatentResizer3D со случайными весами. Это не замер скорости, VRAM или качества на GPU с обученными весами H3/Gemma/HQ; Windows отдельно не запускался. В очень редких старых HQ-проектах нестандартный Scale вне сетки виджета может быть отклонён до генерации. AUTO с очень короткими длительностями отдельных сцен также может остановить очередь между сценами; уже сохранённые сцены остаются на месте.

EN — validation scope: logic was tested on CPU; some generation and decoding paths used model doubles. HQ geometry fixes were additionally tested with a real LatentResizer3D using random weights. These checks do not measure GPU speed, VRAM or output quality with trained H3/Gemma/HQ weights; Windows was not run separately. In very rare legacy HQ projects, an unusual Scale outside the widget grid may be rejected before generation. AUTO with very short individual scene durations can also stop a queue between scenes; previously saved scenes remain available.

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

RU: инструменты RefMod адаптированы из ComfyUI-MiniMaxH3Mod от Luisa / Luisacaotica. Идея продолжения по одному последнему кадру изучена на примере comfyui-AGSoft; в LongForge она встроена в собственный механизм сцен и нативную передачу звука. HQ использует адаптацию апскейлера LBH-123-AI. Уведомления об авторах и сторонние лицензии сохранены в Node Pack.

EN: RefMod tools are adapted from ComfyUI-MiniMaxH3Mod by Luisa / Luisacaotica. Single-final-frame continuation was studied through comfyui-AGSoft and integrated into LongForge's own scene system and native audio handover. HQ uses an adaptation of the LBH-123-AI upscaler. Third-party credits and licenses are retained in the Node Pack.

Files with SHA256: f22e316fcdc2574f792534a1fe2b23008717e3cf06853cfa2897d2c26987f6d7