MiniMax H3 LongForge 7.7 · FL2VA & REF2VA
Начните с ключевой сцены. Добавьте предысторию и продолжение. Соберите фильм со звуком в одном workflow ComfyUI.
Start with the key scene. Add what came before and what happens next. Export the film with sound from one ComfyUI workflow.
Подписка и поддержка / Follow & support
Поддержать разработку можно через Tip в моём профиле Civitai или добровольным переводом в одной из указанных сетей. / Support development through Tip on my Civitai profile or an optional donation on one of the networks below.
BNB Smart Chain — 0xdCf9846A1B0F2fe32E19dC9CFdDC5194CC13D108
TON — UQCeukjBulZw9gni1jv8NLRgtmgHDQ6mUiS2qf3716XobIxA
TRON / TRC20 — THLU3yu8VpoPqP4bMLCp86FRhoCweJ2Qz4
Проверьте, что сеть соответствует адресу и валюте. Спасибо за поддержку! / Check that the network matches the address and currency. Thank you for your support!
Русский
LongForge собирает длинные видео MiniMax H3 из отдельных сцен. Можно продолжать фильм по промптам, переснимать сцены, возвращать сохранённые версии, монтировать и экспортировать видео со звуком. В комплекте LongForge Node Pack, основной workflow FL2VA / REF2VA и отдельный RefMod Studio. Подробные инструкции RU/EN встроены в оба workflow.
🎬 Новое в 7.7 · Before N
Теперь у готовой Scene 1 может появиться предыстория. Например, сначала сгенерируйте сцену, где герой уже в вагоне поезда. Добавьте Before 1, чтобы показать посадку, а Before 2, чтобы показать, как он бежит по платформе. В фильме они идут в порядке Before 2 → Before 1 → Scene 1 → Scene 2…
LongForge берёт начало следующей сцены как контекст для скрытого конца новой Before. Модель генерирует подводку к этому началу. При экспорте скрытый конец убирается, чтобы кадры перекрытия не повторялись. Нумерация обычных сцен сохраняется, а время Before показывается относительно начала Scene 1, например −4.25–0.00 s. Подсказки нод и инструкции в workflow описывают порядок генерации и зависимости между карточками.
Как добавить сцену перед началом
Сохраните Scene 1 через GENERATE NEXT или импортируйте её через IMPORT VIDEO в пустой проект.
В 10 · Project & Scenes нажмите + Before и напишите промпт подводки. Каждое следующее нажатие добавляет карточку раньше предыдущей.
Выберите Action → GENERATE BEFORE и нажмите Run. ONE SCENE генерирует ближайшую ожидающую Before. ALL PENDING проходит все ожидающие карточки от Scene 1 к началу фильма.
Выберите сохранённую Before и нажмите Preview scene для просмотра. После генерации запустите EXPORT FILM → Run, чтобы собрать сохранённые Before и обычные сцены в один файл.
Стык, звук и история Before
Настройки берутся из 11 · Video & Continuity. Эти режимы задают, как начало следующей сцены используется в скрытом конце новой Before.
PROTECTED закрепляет скопированные видеолатенты в скрытом конце.
GUIDE использует видеолатенты как ориентир для сэмплера и восстанавливает защищённое перекрытие перед сохранением.
LAST FRAME берёт первый кадр следующей сцены как один визуальный ориентир.
HARD защищает звуковое перекрытие целиком. SOFT позволяет модели перегенерировать его первые 100 или 200 мс, сохраняя жёсткое ядро. OFF оставляет звук открытым для генерации. AUTO BALANCED / AUTO SAFE оценивают начало следующей сцены. При Increment seed per scene seed новой Before берётся от следующей сцены с шагом −1.
Действия с тейками. На Before доступны PREVIEW SELECTED, REGENERATE SELECTED, VARY SELECTED и HQ SELECTED. Для REPLACE SELECTED выбирайте обычную сцену. Пересъёмка Before отправляет более ранние зависимые карточки в pending. Пересъёмка Scene 1 отправляет в pending все Before. Через Saved chains можно вернуть Before, привязанные к текущей версии Scene 1. Delete снимает выбранную Before и её более ранние зависимые сцены с активного фильма, сохраняя их файлы.
Монтаж. Before 1 берёт начало с первого оставленного кадра Scene 1. При смене Trim In после генерации этот стык становится монтажной склейкой. Чтобы получить подводку к новому началу, перегенерируйте Before 1.
Экспорт и HQ. Before входят в HQ SAVED FILM, Fade film edges, Loop и Color drift. HQ SELECTED создаёт отдельный клип Before. RIFE/FILM и RTX Frame Generation интерполируют непрерывные стыки, включая Before. На непрерывном стыке Before 1 с Scene 1 звук соединяется коротким кроссфейдом до 40 мс. Эталон Color reference scene выбирается среди обычных сцен.
Референсы. FIRST SCENE оставляет обычные референсы для Scene 1, EVERY SCENE передаёт их и Before. В FL2VA подключённые first_frame / last_frame применяются к обычным сценам по их настройкам. Follow-scenes audio начинается с Scene 1. Extra audio history и черновики Prompt Assistant доступны для обычных сцен.
Возможности основного workflow
🎞 Сцены и монтаж. GENERATE NEXT продолжает сохранённый фильм. REGENERATE SELECTED повторяет seed выбранной сцены, VARY SELECTED использует seed +1. Для обычной сцены REPLACE SELECTED закрепляет старое перекрытие со следующей сценой и сохраняет последующие тейки. Trim for export обрезает видео и звук по включённым границам кадра. Continue here создаёт сокращённый тейк для продолжения в LAST FRAME. Saved chains возвращает сохранённые версии, а Recover project восстанавливает активный указатель по файлам проекта.
✨ HQ Finish. UPSCALE повышает разрешение сохранённого видеолатента совместимым 3D latent upscaler. UPSCALE + REFINE добавляет проход через отдельный refiner_model с опциональными 13a · Refiner LoRA и 13b · Refiner VEDA. HQ SELECTED экспортирует одну сцену, а HQ SAVED FILM обрабатывает всю сохранённую цепочку. Доступны Scale / Megapixels / Exact size, а также FULL / AUTO / TILED для памяти refine. FROZEN защищает звук при refine. JOINT семплирует его вместе с видео и сохраняет базовую аудиодорожку в результате.
🌙 Автоэкспорт и отчёт. Для очереди обычных сцен включите Export when done. Сцены сохраняются по одной, затем LongForge собирает фильм с текущими настройками экспорта. Повтор совпадающей незавершённой очереди подхватывает сохранённый результат. Если генерация завершилась и упал экспорт, можно повторить сборку файла. Run report показывает время сцен, работу ускорителей, предупреждения и путь к результату.
🎬 Экспорт. Поддерживаются MP4 / MKV / WEBM, совместимые кодеки H264 / HEVC / AV1 / VP9, CPU и доступные аппаратные энкодеры. Есть ремонт стыков звука и видео, диагностические WAV, Color drift и Loop с режимами CROSSFADE / BEST MATCH / PING-PONG. RIFE/FILM повышают FPS с сохранением длительности и звука. RECOVERY добавляет настройки восстановления в метаданные видео. Для переноса тейков и локальных обрезок сохраняйте папку проекта целиком.
🖼 Референсы и RefMod Studio. В Reference Media карточки фото, видео и аудио можно перетаскивать за ручку ⠿. Обрезки и роли перемещаются вместе с карточкой. RefMod Studio сохраняет VAE-латенты референсов в .safetensors для REF2VA. Поддерживаются FULL / COMPRESSED, отдельные и смешанные bundles, маски, силы, кривые и контроль бюджета токенов. Используйте Check mapping, чтобы сверить метки вроде {refmod:hero}.
🧠 Prompt Assistant. В 16 · Prompt Assistant доступны NATIVE, LOCAL, GGUF, TRANSFORMERS, OLLAMA и SERVER. Generate draft готовит промпт, а Scenario from description — план на 1–16 обычных сцен. Preview sent context показывает, что получит модель, без запроса к ней. Можно задать свои инструкции, выбрать контекст и применить результат кнопкой Apply. Для Vision нужна совместимая модель. Обычная генерация фильма работает с промптами карточек.
⚡ VEDA, Live Preview и Native Cache. Основная ветка использует 08a · VEDA с predictor под выбранный пайплайн. 04a · Live Preview показывает ход сэмплирования, Preview scene декодирует сохранённый тейк. 09 · Native Cache в шаблоне в bypass. OUTPUT требует CFG 1, от 16 шагов и обхода Turbo и VEDA. Для BLOCK + VEDA нужен отдельный экспериментальный переключатель. Поддержка Dynamic VRAM / aimdo из 7.6 [FIX] используется на границах этапов внутри Render при активном aimdo.
NVIDIA RTX VFX при экспорте
Установите оригинальные NVIDIA-ноды и их зависимости. В шаблоне эффекты выключены. ComfyUI Nvidia VFX Nodes
Настройте нужные ноды и включите эффекты в 21 · RTX Export (optional). Оставьте входы images свободными для кадров LongForge.
Запустите EXPORT FILM. Эффекты идут в порядке Super Resolution → Frame Generation → HDR. С RTX Frame Generation установите Frame interpolation × = 1 в 19 · Export Settings. HDR выдаёт 10 бит BT.2020 HLG или PQ. При исходном выборе H264 HDR-экспорт переключается на HEVC.
Установка и первый запуск
Закройте ComfyUI. Скопируйте ComfyUI-H3-LongForge-NodePack в
ComfyUI/custom_nodes/. При обновлении замените папку нод-пака целиком и сохраните резервную копию проектов изComfyUI/output/longforge_native/.Установите
requirements.txtчерез Python ComfyUI. Команды для обычной установки и Windows Portable приведены ниже. Для полной схемы основного workflow нужны внешние типы нод. ComfyUI-KJNodes · Veda-on-ComfyUIПерезапустите ComfyUI, обновите браузер через Ctrl+F5 и откройте H3_LongForge_FL2VA_REF2VA_v7.7.json. Используйте Node Pack 7.7 вместе с workflow этой версии. Для RefMod Studio откройте RefMod_Studio_v7.7.json.
В 01–04 выберите H3 checkpoint, соответствующий текстовый энкодер и оба VAE. В 11 выберите FL2VA или REF2VA под модель. В шаблоне стоят REF2VA, 768×1344, 20 шагов, PROTECTED, MANUAL, 5F и SOFT 100 ms. Turbo и Native Cache обойдены. Веса MiniMax H3
В 10 задайте имя проекта и промпт первой сцены. Запустите GENERATE NEXT → ONE SCENE → Run. После проверки первой сцены добавьте продолжение или + Before. Готовые фильмы появляются в
output/longforge_native/<project>/exports/.
Особенности сборки Before N
Before N проверена на CPU и в браузере. Качество подводки, движения и звука на реальных весах H3 оценивайте на своих сценах. Для сравнения подходят PROTECTED и GUIDE при одинаковом seed.
Seam Lab в этой сборке запускается при наличии двух сохранённых обычных сцен. Для Before-стыков доступен просмотр без A/B. После изменения Trim In кэш может показать прежний стык. Свежий EXPORT FILM использует текущую обрезку.
В очереди Before сочетание 5F + SOFT 200 ms может остановить генерацию на одной из следующих карточек. Для SOFT 200 ms используйте перекрытие от 22F.
После смены NONE / RECOVERY у PREVIEW SELECTED для Before возможен сбой, если сохранено превью только для прежнего режима.
Clean unused может пометить старую Scene 1 к удалению после её пересъёмки, даже когда к ней привязана сохранённая цепочка Before. Если планируете вернуть эту версию, отложите очистку и сохраните папку проекта.
English
LongForge builds long MiniMax H3 videos from individual scenes. Continue a film from prompts, remake scenes, restore saved versions, edit takes and export with sound. The package includes the LongForge Node Pack, the main FL2VA / REF2VA workflow and a separate RefMod Studio workflow. Both workflows include detailed RU/EN guides.
🎬 New in 7.7 · Before N
A saved Scene 1 can now have a lead-in. Start with the hero already on a train, add Before 1 to show them boarding, then add Before 2 to show them running along the platform. The playback order is Before 2 → Before 1 → Scene 1 → Scene 2…
LongForge uses the beginning of the following scene as context at the hidden end of the new Before scene. The model generates the action leading into that opening. Export removes the hidden ending so the overlap plays once. Numbered scenes keep their indices, and Before cards show time relative to the start of Scene 1, such as −4.25–0.00 s. Updated tooltips and workflow guides explain the generation order and dependencies between cards.
How to add a scene before the opening
Save Scene 1 with GENERATE NEXT, or create it with IMPORT VIDEO in an empty project.
Click + Before in 10 · Project & Scenes and write the lead-in prompt. Each additional click adds a card earlier in the film.
Choose Action → GENERATE BEFORE and click Run. ONE SCENE generates the nearest pending Before. ALL PENDING works outward from Scene 1 through all pending Before cards.
Select a saved Before and click Preview scene to review it. Run EXPORT FILM separately to combine the saved Before scenes and the numbered scenes into one file.
Before joins, audio and history
Before uses the same controls in 11 · Video & Continuity. The three methods use the beginning of the following scene at the hidden end of the new Before window.
PROTECTED pins copied video latents in the hidden ending.
GUIDE uses video latents as a sampler guide and restores the protected overlap before saving.
LAST FRAME uses the following scene's first image as a single visual guide.
HARD protects the entire audio overlap. SOFT allows the first 100 or 200 ms of that overlap to be regenerated while preserving a protected core. OFF leaves audio open for generation. AUTO BALANCED / AUTO SAFE assess the beginning of the following scene. With Increment seed per scene, a new Before uses the following scene's seed minus one.
Take actions. Before cards support PREVIEW SELECTED, REGENERATE SELECTED, VARY SELECTED and HQ SELECTED. Use REPLACE SELECTED on numbered scenes. Remaking a Before sends earlier dependent cards back to pending. Remaking Scene 1 makes all Before cards pending. Saved chains can restore Before versions tied to the active Scene 1 take. Delete removes the selected Before and its earlier dependants from the active film while keeping their files.
Editing. Before 1 uses the first kept frame of Scene 1. Changing Trim In after generation turns that join into an edit cut. Regenerate Before 1 to create a lead-in to the new opening.
Export and HQ. HQ SAVED FILM, Fade film edges, Loop and Color drift include Before scenes. HQ SELECTED creates a standalone Before clip. RIFE/FILM and RTX Frame Generation interpolate across continuous joins, including Before joins, and respect edit cuts. At a continuous Before 1 to Scene 1 join, audio blends with a crossfade of up to 40 ms. Color reference scene uses a numbered scene.
References. FIRST SCENE supplies regular references to Scene 1. EVERY SCENE also supplies them to Before scenes. In FL2VA, the connected first_frame / last_frame inputs apply to numbered scenes according to their settings. Follow-scenes audio starts at Scene 1. Extra audio history and Prompt Assistant drafts are available for numbered scenes.
Main workflow features
🎞 Scenes and editing. GENERATE NEXT continues the saved film. REGENERATE SELECTED reuses the selected scene's seed, and VARY SELECTED uses seed +1. For a numbered scene, REPLACE SELECTED pins its old overlap with the next scene and keeps the following takes. Trim for export cuts video and audio together using inclusive frame bounds. Continue here makes a shortened take for LAST FRAME continuation. Saved chains restores saved versions, and Recover project rebuilds the active pointer from project files.
✨ HQ Finish. UPSCALE increases the resolution of saved video latents using a compatible 3D latent upscaler. UPSCALE + REFINE adds a pass through a separate refiner_model with optional 13a · Refiner LoRA and 13b · Refiner VEDA. HQ SELECTED exports one scene, and HQ SAVED FILM processes the saved chain. Choose Scale / Megapixels / Exact size and FULL / AUTO / TILED for refine memory. FROZEN protects audio during refinement. JOINT samples audio with video and retains the base soundtrack in the result.
🌙 Automatic export and reporting. Enable Export when done for a queue of numbered scenes. LongForge saves each scene and then assembles the film with the current export settings. Rerunning a matching unfinished queue picks up saved progress. If generation completed and export failed, you can retry the export. Run report shows scene timings, accelerator activity, warnings and the output path.
🎬 Export. Choose MP4 / MKV / WEBM, compatible H264 / HEVC / AV1 / VP9 codecs, and CPU or available hardware encoders. Export options include audio and video seam repair, diagnostic WAVs, Color drift and CROSSFADE / BEST MATCH / PING-PONG loops. RIFE/FILM raises the frame rate while preserving duration and sound. RECOVERY embeds settings for workflow recovery. Keep the whole project folder when moving takes and local trims.
🖼 References and RefMod Studio. Drag image, video and audio cards by the ⠿ handle in Reference Media. Trims and roles move with each card. RefMod Studio saves VAE-encoded references as .safetensors for REF2VA, with FULL / COMPRESSED modes, separate and mixed bundles, masks, strengths, curves and token budgets. Use Check mapping to verify aliases such as {refmod:hero}.
🧠 Prompt Assistant. 16 · Prompt Assistant supports NATIVE, LOCAL, GGUF, TRANSFORMERS, OLLAMA and SERVER. Generate draft prepares a prompt, while Scenario from description plans 1–16 numbered scenes. Preview sent context shows the model input without calling the model. Set your own instructions, choose the context and use Apply to transfer the draft. Vision requires a compatible model. Ordinary film runs use the prompts on the cards.
⚡ VEDA, Live Preview and Native Cache. The generation branch uses 08a · VEDA with a predictor that matches the pipeline. 04a · Live Preview shows sampling progress, while Preview scene decodes the saved take. 09 · Native Cache is bypassed in the template. OUTPUT requires CFG 1, at least 16 steps, and bypassed Turbo and VEDA. BLOCK + VEDA requires its explicit experimental switch. The 7.6 [FIX] Dynamic VRAM / aimdo cleanup runs at Render stage boundaries when aimdo is active.
NVIDIA RTX VFX at export
Install the original NVIDIA nodes and their dependencies. The effects are off in the template. ComfyUI Nvidia VFX Nodes
Configure the original nodes and enable the desired effects in 21 · RTX Export (optional). Leave their images inputs free for LongForge to supply frames.
Run EXPORT FILM. The effects run in Super Resolution → Frame Generation → HDR order. Set Frame interpolation × = 1 in 19 · Export Settings for RTX Frame Generation. HDR exports in 10-bit BT.2020 HLG or PQ and switches H264 to HEVC when needed.
Installation and first run
Close ComfyUI and copy ComfyUI-H3-LongForge-NodePack into
ComfyUI/custom_nodes/. When updating, replace the whole node-pack folder and back up projects inComfyUI/output/longforge_native/.Install
requirements.txtwith ComfyUI's Python. Commands for standard and Windows Portable installs are below. The complete main template uses external node types. ComfyUI-KJNodes · Veda-on-ComfyUIRestart ComfyUI, refresh with Ctrl+F5 and open H3_LongForge_FL2VA_REF2VA_v7.7.json. Pair the workflow with the 7.7 Node Pack. For RefMod Studio, open RefMod_Studio_v7.7.json.
Select the H3 checkpoint, matching text encoder and both VAEs in 01–04. Match FL2VA or REF2VA to the model in 11. The template starts with REF2VA, 768×1344, 20 steps, PROTECTED, MANUAL, 5F and SOFT 100 ms. Turbo and Native Cache are bypassed. MiniMax H3 weights
Set a project name and the first prompt in 10. Run GENERATE NEXT → ONE SCENE. Once you have reviewed the first scene, add a continuation or click + Before. Finished films appear in
output/longforge_native/<project>/exports/.
Notes for this Before N build
Before N was tested on CPU and in the browser. Evaluate lead-in quality, motion and sound on your own scenes with trained H3 weights. Compare PROTECTED and GUIDE with the same seed.
Seam Lab requires two saved numbered scenes to run in this build. Before joins are available for review without A/B alternatives. After a Trim In change, the preview cache can still show the old join. A fresh EXPORT FILM uses the current trim.
With 5F + SOFT 200 ms, a Before queue can stop on a later card. Use an overlap of 22F or more with SOFT 200 ms.
PREVIEW SELECTED for a Before scene can fail after switching NONE / RECOVERY when only the previous mode's preview is cached.
Clean unused can list an old Scene 1 for removal after a remake even when a saved Before chain still depends on it. If you plan to restore that version, defer cleanup and keep the project folder.
Комплект и зависимости / Package & dependencies
ComfyUI-H3-LongForge-NodePack/ — Ноды и интерфейс LongForge / LongForge nodes and UI
H3_LongForge_FL2VA_REF2VA_v7.7.json — Основной workflow / Main workflow
RefMod_Studio_v7.7.json — Подготовка и просмотр RefMod / RefMod creation and inspection
Нужны ComfyUI с нативным MiniMax H3 и V3 node API, веса модели, текстовый энкодер и H3 Video/Audio VAE. Для превью и экспорта нужен FFmpeg с libx264/AAC. Сначала проверяется PATH, затем используется imageio-ffmpeg. Веса и внешние ноды устанавливаются отдельно.
Requires ComfyUI with native MiniMax H3 and the V3 node API, model weights, the matching text encoder and the H3 Video/Audio VAEs. Preview and export use FFmpeg with libx264/AAC. LongForge checks PATH first and falls back to imageio-ffmpeg. Install weights and external nodes separately.
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 install · из папки ComfyUI в его окружении / from the ComfyUI directory in its environment
python -m pip install -r custom_nodes/ComfyUI-H3-LongForge-NodePack/requirements.txtVEDA predictors
Положите predictor в ComfyUI/models/veda/ и выберите его в 08a. Для работы без VEDA переведите 08a в bypass через Ctrl+B. / Place the predictor in ComfyUI/models/veda/ and select it in 08a. Use Ctrl+B to bypass 08a when running without VEDA.
FL2VA — minimax_h3_t2va_veda_8nfe_600step_preview_fp8.safetensors
REF2VA — minimax_h3_r2va_veda_preview_fp8.safetensors
Настройки BLOCK / BLOCK settings
Threshold — 0.12 (по умолчанию / default). Диапазон / Range — 0–1.
Window start / end — 0.08 / 0.95 (по умолчанию / default). Диапазон / Range — 0–1, start < end.
Max reuses — 2 (по умолчанию / default). Диапазон / Range — 0–10.
Storage — cpu (по умолчанию / default). Значения / Values — cpu / gpu.
Metric stride — 8 (по умолчанию / default). Диапазон / Range — 1–32.
Console report — true (по умолчанию / default). Значения / Values — true / false.
BLOCK + VEDA (experimental) — false (по умолчанию / default). Значения / Values — true / false.
BLOCK requires CFG 1, at least 4 steps and a supported Euler / RES multistep / RES multistep CFG++ sampler. Storage chooses where cached tensors live. Metric stride controls how densely the cache samples tensor values when measuring differences.
SERVER API
RU. В 16 · Prompt Assistant → Backend → SERVER укажите базовый адрес OpenAI-compatible API и имя модели. Для Ollama выберите OLLAMA. Стандартный адрес Ollama — http://127.0.0.1:11434. Для SERVER задайте ключ через LONGFORGE_LLM_API_KEY. Для удалённого сервера с ключом используйте HTTPS и добавьте точное имя хоста в LONGFORGE_LLM_API_HOSTS.
EN. Set the OpenAI-compatible base URL and model name in 16 · Prompt Assistant → Backend → SERVER. Choose OLLAMA for Ollama, whose default address is http://127.0.0.1:11434. Set the SERVER API key through LONGFORGE_LLM_API_KEY. For a remote server with a key, use HTTPS and add the exact hostname to LONGFORGE_LLM_API_HOSTS.
Ссылки / Links
Авторы и благодарности / Credits
BLOCK cache. Адаптация T8mars, Apache-2.0. / Adapted from T8mars, Apache-2.0. comfyui-minimax-h3-blockcache-T8
OUTPUT cache / LAST FRAME. Подходы изучены на примере AGSoft. Интеграция в систему сцен выполнена в LongForge. / LongForge studied the approaches in AGSoft and integrated them into its own scene system. comfyui-AGSoft
RefMod. Адаптация работы Luisa / Luisacaotica. / Adapted from Luisa / Luisacaotica. ComfyUI-MiniMaxH3Mod
HQ. Адаптация 3D latent upscaler от LBH-123-AI. / Adaptation of the 3D latent upscaler by LBH-123-AI. MiniMax H3 Latent Upscaler
VEDA, Live Preview, RTX VFX. Внешние ноды авторов соответствующих паков. / External nodes from the respective pack authors. VEDA · KJNodes · NVIDIA VFX Nodes
Уведомления об авторстве и сторонние лицензии находятся в Node Pack. / Third-party notices and licenses are included in the Node Pack.
