MiniMax H3 LongForge 7.3 · FL2VA & REF2VA
От первой сцены до готового фильма со звуком — в одном workflow ComfyUI.
From the first scene to a finished film with audio — in one ComfyUI workflow.
Подписка и поддержка / Follow & support
Поддержать разработку можно кнопкой 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.3
✨ HQ готовых сцен — улучшайте то, что уже получилось.
Сначала сгенерируйте фильм в базовом разрешении, затем примените UPSCALE или UPSCALE + REFINE к сохранённым сценам. Повторная базовая генерация не нужна: HQ использует сохранённые латенты.
Одна сцена: выберите её карточку → 13 · HQ Finish → UPSCALE / UPSCALE + REFINE → 10 · Action → HQ SELECTED → Run. В exports/ проекта появится отдельный MP4 всей сцены; путь и превью — в Render & Export. Активный фильм не меняется, Trim к отдельному клипу не применяется. Качество кодирования задаёт Export CRF в Render & Export.
Весь сохранённый фильм: настройте HQ → Action → HQ SAVED FILM → Run, затем EXPORT FILM. Все сохранённые сцены проходят HQ по очереди в одном выходном разрешении. Новая цепочка становится активной только после успешной обработки всех сцен; предыдущая остаётся в Saved chains. Базовые латенты, исходный звук, длительности, контекст продолжения и индивидуальные Trim сохраняются. Ожидающие карточки не генерируются.
UPSCALE выполняет только обученный латентный апскейл, без H3 diffusion, CLIP и сэмплирования. UPSCALE + REFINE добавляет второй проход через чистый refiner_model: используются сохранённые prompt, seed и sigma-shift сцены, сохранённые RefMod и текущие подключённые обычные референсы. Текущий seed Sampling и несохранённый текст карточки их не заменяют. Каждый новый HQ-проход начинается с базового латента, а не с результата предыдущего апскейла.
Для этих действий можно менять настройки HQ. При обычном продолжении фильма проверка единого разрешения и HQ сохраняется. Continue here пока не поддерживается; импортированную сцену можно обработать через UPSCALE, без REFINE. Ошибка или Cancel до публикации сохраняет активный фильм. Отчёт HQ находится в hq_reports/; повтор HQ SAVED FILM начинает обработку заново, без возобновления с последней сцены.
🎛 HQ Finish — нужные настройки появляются по выбору режима.
В Output size выберите Scale / Megapixels / Exact size. При OFF настройки скрыты, при UPSCALE не показываются поля refine. Дополнительные параметры доступны через Advanced HQ settings; FULL / AUTO / TILED показывают соответствующие настройки памяти. Refine audio → FROZEN оставляет звук нетронутым во время refine; JOINT семплирует его совместно с видео, но в готовом результате также сохраняет исходный звук. JOINT экспериментальный.
🔄 REPLACE SELECTED — новая версия одной сцены с сохранением следующих.
Выберите сохранённую карточку, измените prompt → Action → REPLACE SELECTED → Run. Выбранная сцена переснимается с seed предыдущего тейка + 1. Если после неё уже есть сцены, её старый латентный конец закрепляется, а следующие сцены перепривязываются без перегенерации их видео и звука. Их Trim и миниатюры сохраняются; заменённая сцена начинает с полного диапазона. Старая цепочка остаётся в Saved chains.
Конец закреплён намеренно: новый prompt может изменить происходящее внутри сцены, но не отменяет сохранённую конечную часть, необходимую следующей сцене. Для замены в середине должны совпадать длительность, overlap и HQ; если AUTO выбирает другой overlap, используйте MANUAL. Импортированные и Continue here тейки не поддерживаются. Функция экспериментальная: проверьте видео и звук на стыках, особенно с LAST FRAME. Export when done после успешной замены экспортирует фильм, если все карточки уже сохранены; после ошибки экспорта повторяется только экспорт без загрузки H3/CLIP.
📐 Разрешение в мегапикселях.
В 11 · Video & Continuity → Resolution → Megapixels задайте Target megapixels и Aspect ratio. Ширина и высота рассчитываются автоматически с округлением до 32 пикселей; фактический размер показан рядом. Здесь 1 MP = 1024 × 1024 пикселя. Custom сохраняет ручной ввод размеров. Старые workflow и подключённые width/height не пересчитываются при загрузке; базовое разрешение внутри готового фильма по-прежнему фиксировано.
В HQ режим Megapixels задаёт размер с пропорциями исходника. Для API приоритет такой: точные ширина/высота → Target MP → Scale; Target MP = 0 отключает расчёт по MP. HQ не уменьшает исходное изображение.
📝 Ассистент и сохранность проектов.
В новом проекте первая карточка сценария открывает историю с начала; при продолжении — продолжает сохранённый фильм. Generate draft / Scenario from description отправляют только ветку ассистента: пустая Scene 1 больше не запускает генерацию фильма вместе с запросом к LLM.
Исправлены восстановление настроек HQ, передача RefMod-псевдонимов в refine, миниатюры после HQ без новых превью и запуск FFmpeg в Seam Lab из фонового терминала. Clean unused сохраняет все HQ-версии, связанные с активным фильмом, включая повторные HQ-проходы и возврат к оригиналу односценного фильма. Удалить их можно отдельно через подтверждённую очистку Saved chains. Временные клипы HQ SELECTED и обычные одиночные остатки пересъёмок остаются доступными для очистки.
Автоэкспорт и циклические ролики
🌙 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 не гарантируют незаметного перехода для любого сюжета.
Установка и первый запуск
Закройте 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.3.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. После HQ SAVED FILM без новых превью имеющиеся миниатюры переносятся с исходных тейков. 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 удаляет папку проекта. Обычные REGENERATE / VARY в середине делают поздние сцены ожидающими; REPLACE SELECTED сохраняет их. 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.3.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; размер через Scale / Megapixels / Exact size. Нужен совместимый 3D latent upscaler. Точные размеры задаются парой, кратны 32, сохраняют пропорции и не уменьшают оси. Для refine — FULL / AUTO / TILED, временные окна и бюджет памяти; AUTO/TILED не гарантируют отсутствие OOM. HQ можно применять во время генерации или отдельно к готовым сценам. Контекст продолжения берётся из базовых AV-латентов; refine использует чистую ветку refiner_model без Turbo/VEDA. Подробности и действия HQ — в начале описания.
Экспорт · 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.3
✨ HQ for saved scenes — improve the result you already like.
Generate at base resolution first, then apply UPSCALE or UPSCALE + REFINE to saved scenes. There is no new base-generation pass: HQ starts from saved latents.
One scene: select its card → 13 · HQ Finish → UPSCALE / UPSCALE + REFINE → 10 · Action → HQ SELECTED → Run. A standalone full-scene MP4 appears in the project's exports/, with its path and preview in Render & Export. The active film stays unchanged; export Trim is not applied to this separate clip. Export CRF in Render & Export controls its encoding quality.
The saved film: configure HQ → Action → HQ SAVED FILM → Run, then EXPORT FILM. All saved scenes are processed sequentially at one output resolution. The new chain becomes active only after every scene succeeds; the previous chain stays in Saved chains. Base latents, original audio, duration, continuation context and individual trims are preserved. Pending cards are not generated.
UPSCALE runs only the learned latent upscaler, without H3 diffusion, CLIP or sampling. UPSCALE + REFINE adds a second pass through the clean refiner_model, using each take's saved prompt, seed and sigma shifts, saved RefMods and currently connected ordinary references. The current Sampling seed and unsaved card text do not replace those saved values. Each HQ run starts from the base latent, never from the previous upscale.
These actions allow changing HQ settings. Normal film continuation retains its uniform-resolution and HQ checks. Continue here cuts are unsupported; imported scenes support UPSCALE, without REFINE. Failure or cancellation before publication preserves the active film. HQ reports live in hq_reports/; repeating HQ SAVED FILM starts again rather than resuming at the last scene.
🎛 HQ Finish — controls follow the selected mode.
Choose Output size → Scale / Megapixels / Exact size. OFF hides settings; UPSCALE hides refinement fields. Advanced HQ settings exposes additional controls, while FULL / AUTO / TILED show the relevant memory settings. Refine audio → FROZEN leaves audio untouched during refinement; JOINT samples audio alongside video but still delivers the original audio. JOINT is experimental.
🔄 REPLACE SELECTED — remake one scene while keeping its successors.
Select a saved card, edit its prompt → Action → REPLACE SELECTED → Run. The selected scene is regenerated with its previous take's seed + 1. If saved scenes follow it, its original latent ending is pinned and later scenes are re-parented without regenerating their video/audio. Their trims and thumbnails are retained; the replacement starts untrimmed. The old chain stays in Saved chains.
The ending is pinned deliberately: a new prompt can change what happens inside the scene, but cannot remove the protected ending needed by its successor. Replacing a scene in the middle requires matching duration, overlap and HQ settings; use MANUAL if AUTO chooses a different overlap. Imported scenes and Continue here cuts are unsupported. This is experimental: review visual and audio joins, especially with LAST FRAME. Export when done exports after a successful replacement if every card is already saved; export failures retry export alone without loading H3/CLIP.
📐 Resolution in megapixels.
In 11 · Video & Continuity → Resolution → Megapixels, set Target megapixels and Aspect ratio. Width and height are calculated automatically and rounded to multiples of 32 pixels, with actual dimensions displayed alongside. Here 1 MP = 1024 × 1024 pixels. Custom retains manual sizing. Legacy workflows and connected width/height are not resized on load; base geometry remains fixed within a saved film.
HQ Megapixels preserves the source aspect ratio. For API inputs, explicit width/height takes priority over Target MP, which takes priority over Scale; Target MP = 0 disables MP sizing. HQ cannot shrink the source image.
📝 Assistant and project preservation.
In a new project, the opening scenario card starts the story from the beginning; with an existing film, it continues the saved story. Generate draft / Scenario from description submit only the assistant branch, so an empty Scene 1 no longer triggers film generation alongside the LLM request.
Fixed HQ settings recovery, RefMod aliases during refinement, thumbnails after HQ without new previews, and Seam Lab FFmpeg execution from a background terminal. Clean unused preserves all HQ versions linked to the active film, including repeated HQ passes and restoring the original of a one-scene film. Explicit confirmed Saved chains cleanup can still remove them. Temporary HQ SELECTED takes and ordinary single-scene regeneration leftovers remain eligible for cleanup.
Automatic export and looping
🌙 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.
Installation and your first run
Stop ComfyUI and install or replace the whole
ComfyUI/custom_nodes/ComfyUI-H3-LongForge-NodePack/folder. Back up projects fromoutput/longforge_native/.Install
requirements.txtwith 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.3.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. After HQ SAVED FILM without new previews, existing thumbnails are carried over from source takes. 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. Ordinary REGENERATE / VARY in the middle makes later scenes pending; REPLACE SELECTED keeps them. GENERATE NEXT on a completed film does not regenerate scenes.
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.3.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, with Scale / Megapixels / Exact size. Requires a compatible 3D latent upscaler. Exact dimensions must be set together, be multiples of 32, preserve aspect ratio and never shrink either axis. Refinement offers FULL / AUTO / TILED, temporal windows and memory budgeting; AUTO/TILED cannot guarantee freedom from OOM. HQ can run during generation or separately on saved scenes. Continuation uses base AV latents; refinement uses the clean refiner_model branch without Turbo/VEDA. See the new HQ actions at the start of this description.
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.3.jsonRefMod_Studio_v7.3.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.3.
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.3 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.txtVEDA 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
Авторы и благодарности / 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.