MiniMax H3 LongForge 7.5 · FL2VA & REF2VA

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

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

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

AI Bob Public · AI DEV LAB

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

BNB Smart Chain — 0xdCf9846A1B0F2fe32E19dC9CFdDC5194CC13D108

TON — UQCeukjBulZw9gni1jv8NLRgtmgHDQ6mUiS2qf3716XobIxA

TRON / TRC20 — THLU3yu8VpoPqP4bMLCp86FRhoCweJ2Qz4

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

Русский

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

Главное в 7.5

✨ HQ Finish — точнее апскейл длинных сцен. В режиме Temporal chunks нормализация учитывает всю сцену, а на границах частей используются реальные соседние кадры. Это устраняет различия, вызванные независимой обработкой частей. Уже сохранённые HQ-тейки не пересчитываются. Расход VRAM зависит от длительности и разрешения.

⚡ Отдельное ускорение UPSCALE + REFINE. 13a · Refiner LoRA позволяет подключить подходящую LoRA для второго прохода, а 13b · Refiner VEDA — настроить разреженность независимо от VEDA основной генерации. Обе ноды подключены к отдельному входу refiner_model и находятся в bypass по умолчанию. Включайте только нужные ноды и сравнивайте скорость и качество на своих сценах, особенно при апскейле до 2K.

🎨 Color drift — выравнивание цвета при экспорте. В 19 · Export Settings режим BRIGHTNESS плавно корректирует яркость и контраст, а COLOR — ещё и оттенок. Выберите эталонную сцену и силу 0–1 (по умолчанию 0.5, эталон — сцена 1). По умолчанию стоит OFF. Замер требует дополнительного декодирования; исходные тейки, превью и отдельные клипы HQ SELECTED не меняются. Если свет меняется по замыслу, оставьте OFF.

🧠 Prompt Assistant — MTP auto для NATIVE. На версиях ComfyUI с поддержкой MTP ассистент включает автоматический режим для совместимых моделей. Ускорение зависит от модели и оборудования.

Исправления: снижен дополнительный расход RAM при замере Color drift; исправлено восстановление при чрезмерно вложенном JSON; Clean unused защищён от удаления чужих тейков через ссылки.

Prompt Assistant

🧠 Prompt Assistant — ваша модель, ваши инструкции и понятный контекст.

Выбор модели — не только Gemma. В 16 · Prompt Assistant → Backend доступны:

NATIVE — генеративная текстовая модель, совместимая с ComfyUI TextGenerate, через 16a. Gemma — один из примеров; текстовый энкодер H3 для этой задачи не подходит.
LOCAL — автоматический выбор локального runtime для выбранной модели.
GGUF / TRANSFORMERS — ручной выбор runtime; локальные модели размещаются в ComfyUI/models/llm/.
OLLAMA — подключение к серверу Ollama.
SERVER — локальный сервер или внешний сервис с OpenAI-compatible API.

Поддержка зависит от модели и выбранного runtime: произвольный файл весов не становится совместимым автоматически. Для Vision нужна модель с поддержкой изображений, а для GGUF — также подходящий vision projector. API настраивается через адрес сервера и имя модели; ключ задаётся отдельно, через переменную среды. Подробности — в разделе SERVER API ниже.

✍️ Writing instructions — три режима написания.

BUILTIN — встроенная инструкция LongForge для промптов MiniMax H3.

CUSTOM — ваш текст заменяет встроенную творческую инструкцию: можно задать свой стиль, структуру описания и правила написания.

CUSTOM + BUILTIN — встроенная инструкция сохраняется, а ваш текст добавляет требования к ней.

Разница — в использовании встроенного руководства по написанию. Во всех режимах остаются обязательные поля H3, правила времени, доступные метки референсов и проверка результата: CUSTOM не отключает формат, необходимый генератору. Свой текст — до 16 000 символов.

👁 Контроль того, что получает модель.

Отдельно включаются Include previous prompt, Include reference pictures и Include tail frames. Два последних параметра относятся к Vision; выключение картинок не удаляет текстовые метки и роли референсов. Текущая идея сцены, её длительность и обязательные правила задачи сохраняются. Аудио ассистент не прослушивает.

Preview sent context подготавливает и показывает системную инструкцию, пользовательскую задачу и прикрепляемые кадры для выбранной сцены — без вызова LLM. Это помогает проверить, попали ли свои инструкции и нужный контекст. Для Scenario дополнительно формируется общая идея, количество карточек и формат ответа сценария; предпросмотр одной сцены не заменяет сценарную задачу.

Generate draft готовит промпт выбранной сцены; Scenario from description — план на 1–16 новых сцен по идее и общей длительности. Для отдельного промпта доступны 1–8 шотов. Результат проверяется, отклонённые карточки могут запрашиваться повторно; готовый текст переносится в сцены только после Apply. Эти кнопки находятся в 10 · Project & Scenes. Обычная генерация фильма ассистента не вызывает.

🎛 Знакомый интерфейс и компактнее расположенные ноды.

Поля Prompt Assistant меняются по выбранному Backend, Vision и режиму инструкций. В комплекте — основной workflow и отдельный RefMod Studio.

Custom instructions сохраняются в workflow, а при Metadata = RECOVERY также входят в метаданные экспортированного видео. Для публикации используйте текст, которым готовы поделиться; API-ключ в это поле вводить не нужно.

Готовые сцены: HQ, замена и разрешение

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

✨ 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 не уменьшает исходное изображение.

📝 Сохранённые улучшения 7.3.

В новом проекте первая карточка сценария открывает историю с начала; при продолжении — продолжает сохранённый фильм. 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.5.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/.

Принятый шаблон настроен на REF2VA, 768×1344, 20 шагов и выключенную Turbo LoRA. Референсы применяются в EVERY SCENE, их размер — max, режим продолжения — PROTECTED. Перед первым запуском проверьте модель, разрешение, режим продолжения и собственные ресурсы памяти. Для 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 защищают аудиопрефикс, допускают изменение его конца или отключают защищённый контекст, сохраняя генерацию звука. В принятом шаблоне — PROTECTED / MANUAL / 5F / SOFT; overlap задаёт скрытый контекст, а не количество отдельных входных изображений для LAST FRAME. Точное сохранение лица и незаметные стыки не гарантируются.

Длительность. 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 — ниже.

Prompt Assistant · 16. Выбор Backend, Writing instructions, контекста и предварительный просмотр запроса описаны в разделе «Prompt Assistant». Если LLM не нужна, фильм можно генерировать с вручную написанными промптами. Для NATIVE выберите отдельную совместимую генеративную модель в 16a; для остальных Backend используйте их собственные настройки.

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.5.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 с опциональными 13a / 13b. Подробности и действия 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.5

✨ HQ Finish — more consistent upscaling across long scenes. With Temporal chunks enabled, normalization uses the whole scene and chunk boundaries use the actual neighboring frames. This removes differences caused by processing chunks independently. Existing HQ takes are not recalculated. VRAM use depends on duration and resolution.

⚡ Separate acceleration for UPSCALE + REFINE. 13a · Refiner LoRA can load a compatible LoRA for the second pass, while 13b · Refiner VEDA lets you set sparsity independently of the generation branch. Both nodes feed the separate refiner_model input and are bypassed by default. Enable only the nodes you need and compare speed and quality on your own scenes, especially at 2K.

🎨 Color drift — export-time color correction. In 19 · Export Settings, BRIGHTNESS smoothly adjusts brightness and contrast; COLOR also adjusts tint. Pick a reference scene and a strength from 0–1 (defaults: 0.5, scene 1). The default mode is OFF. Measurement requires an additional decode pass; source takes, previews and standalone HQ SELECTED clips are unchanged. Leave it off if the lighting changes are intentional.

🧠 Prompt Assistant — MTP auto for NATIVE. On ComfyUI builds that support MTP, the assistant uses automatic MTP for compatible models. Speed gains depend on the model and hardware.

Fixes: reduced extra RAM during Color drift measurement, fixed recovery from excessively nested JSON, and protected Clean unused against deleting another project's takes through links.

Prompt Assistant

🧠 Prompt Assistant — choose the model, writing rules and context.

Model choice goes beyond Gemma. 16 · Prompt Assistant → Backend offers:

NATIVE — a generation-capable text model compatible with ComfyUI TextGenerate, connected through 16a. Gemma is one example; H3's conditioning encoder is unsuitable for this task.
LOCAL — automatic runtime selection for the chosen local model.
GGUF / TRANSFORMERS — manual runtime selection; local models belong in ComfyUI/models/llm/.
OLLAMA — an Ollama server.
SERVER — a local server or external service exposing an OpenAI-compatible API.

Compatibility depends on the model and runtime; arbitrary weights are not automatically supported. Vision requires an image-capable model and, for GGUF, a matching vision projector. API setup uses the server URL and model name, with the key supplied separately through an environment variable. See SERVER API below.

✍️ Writing instructions — three modes.

BUILTIN uses LongForge's built-in writing guide for MiniMax H3 prompts.

CUSTOM replaces the built-in creative instruction with your own text: specify your preferred style, descriptions and writing rules.

CUSTOM + BUILTIN retains the built-in guide and adds your requirements.

The difference is whether the built-in writing guide is included. Required H3 fields, timing rules, available reference labels and output validation remain active in every mode. CUSTOM does not disable the format needed by the generator. Custom text supports up to 16,000 characters.

👁 Control what the model receives.

Toggle Include previous prompt, Include reference pictures and Include tail frames separately. The latter two apply to Vision; disabling pictures does not remove textual reference labels or roles. The current scene idea, duration and required task rules remain included. The assistant does not listen to audio.

Preview sent context prepares and displays the selected scene's system instructions, user task and attached frames without calling the LLM. Check your custom instructions and context before generating. Scenario requests additionally include the overall brief, card count and scenario response format; a single-scene preview is not the full scenario task.

Generate draft writes a prompt for the selected scene; Scenario from description plans 1–16 new scenes from an idea and total duration. Single-scene prompts support 1–8 shots. Output is validated and rejected cards may be retried. Nothing replaces your cards until Apply. Both buttons are in 10 · Project & Scenes; ordinary film generation does not invoke the assistant.

🎛 Familiar controls and a more compact canvas.

Prompt Assistant shows relevant fields according to Backend, Vision and instruction mode. The package includes the main workflow and a separate RefMod Studio.

Custom instructions are saved in the workflow and, with Metadata = RECOVERY, in the exported video's recovery metadata. Use instructions you are happy to share when publishing. API keys belong in the environment, not in this field.

Saved scenes: HQ, replacement and resolution

When HQ is enabled during generation, previews and export use the HQ video. The take retains its base latents and audio; a separate base-resolution preview is not created automatically.

✨ 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 a separate 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.

📝 Improvements retained from 7.3.

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 from output/longforge_native/.
Install requirements.txt with ComfyUI's Python. The complete template also needs ComfyUI-KJNodes and Veda-on-ComfyUI, including dependencies. Separate T8 and original RefMod installations are unnecessary; commands and links are below.
Restart, refresh with Ctrl+F5, then open H3_LongForge_FL2VA_REF2VA_v7.5.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 accepted template uses REF2VA, 768×1344, 20 steps and Turbo LoRA bypassed. References use EVERY SCENE with size max; continuation uses PROTECTED. Check your model, dimensions, continuation settings and available memory before the first run. 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. The accepted template uses PROTECTED / MANUAL / 5F / SOFT; overlap defines hidden context, not a count of separate LAST FRAME 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.

Prompt Assistant · 16. Backend, Writing instructions, context switches and request preview are explained in the Prompt Assistant section. An LLM is optional: film generation also works with manually written prompts. For NATIVE, select a separate compatible generation-capable model in 16a; other backends use their own model settings.

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.5.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 a separate refiner_model branch with optional 13a / 13b. See the HQ actions above.

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.5.json
RefMod_Studio_v7.5.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.5.

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.5 Node Pack and workflows together.

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

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

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

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

VEDA predictors

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

FL2VA — minimax_h3_t2va_veda_8nfe_600step_preview_fp8.safetensors

REF2VA — minimax_h3_r2va_veda_preview_fp8.safetensors

SERVER API

16 · Prompt Assistant → Backend → SERVER: задайте базовый адрес OpenAI-compatible API (например https://api.example.com/v1) и имя модели. Для Ollama выберите OLLAMA; стандартный адрес — http://127.0.0.1:11434. / Set the OpenAI-compatible base URL and model name under SERVER. For Ollama choose OLLAMA; its default URL is http://127.0.0.1:11434.

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.

Files with SHA256: 65a6c4b4fda94b13e6a473d7cede7600499ef0f246afed3da52bf9dfd0f4380b