# Neron Video MiniMax H3 I2V v2.0

> ## Важное обновление

> В ноде my_turbo_color_fix.py была обнаружена ошибка в расчёте обработки кадров, которая могла приводить к повышенному потреблению и некорректному освобождению памяти. (Вызывало ошибку нехватки памяти так как отправляла весь пул на обработку не выгрузив модели из памяти видеокарты.)

Ошибка исправлена: переработана логика обработки кадров и управления памятью.

Если вы скачивали предыдущую версию, настоятельно рекомендуется заново скачать актуальный архив, переустановить custom nodes и перезапустить ComfyUI.

Приношу извинения за доставленные неудобства и благодарю за понимание.

---

## Русский

### Описание

Готовый workflow для генерации видео MiniMax H3 Image-to-Video в ComfyUI.

Включает:

- подготовку исходного изображения;

- автоматическое создание промпта;

- ручное и автоматическое управление камерой;

- режимы генерации на 8 и 20 шагов;

- подключение до пяти LoRA;

- интерполяцию кадров;

- цветокоррекцию и AI-апскейл.

### Как использовать

1. Загрузите исходное изображение.

2. Выберите разрешение и соотношение сторон.

3. Опишите сцену обычным языком.

4. Автопромптер подготовит технический промпт для MiniMax H3.

5. При необходимости настройте камеру вручную.

6. Выберите режим генерации: 8 или 20 шагов.

7. Подключите нужные LoRA.

8. После генерации выполните интерполяцию, цветокоррекцию или апскейл.

### Требования к видеопамяти

Workflow может работать на видеокартах с 8 ГБ VRAM.

При недостатке памяти:

- уменьшите разрешение или длительность видео;

- используйте режим 8 шагов;

- отключите необязательные операции;

- выполняйте AI-апскейл после генерации.

### Режимы генерации

#### 20 шагов

Основной режим с более стабильными цветом, яркостью и насыщенностью. Обычно дополнительная цветокоррекция не требуется.

#### 8 шагов

Быстрый режим с меньшей нагрузкой на видеокарту. В длинных видео возможны постепенные изменения цвета, яркости и насыщенности.

Для коррекции результата используйте Manual Color & Upscale Panel.

### Камера и автопромптер

Автопромптер анализирует изображение и преобразует обычное описание сцены в технический промпт.

Если движение камеры не задано, камера остаётся неподвижной. Если движение указано, автопромптер добавляет направление, дистанцию, углы и траекторию.

Также доступен ручной режим без языковой модели. В нём можно настроить:

- тип кадра;

- положение и дистанцию камеры;

- движение камеры;

- длительность видео.

Длительность указывается в начале промпта в секундах и используется для расстановки временных меток.

### LoRA

Нода H3 LoRA Selector — 5 Slots позволяет:

- подключить до пяти LoRA;

- отдельно включать каждый слот;

- настраивать силу каждой LoRA;

- использовать LoRA в режимах 8 и 20 шагов.

Активные LoRA применяются последовательно: от первого слота к пятому.

### Обработка изображения

#### Interactive Image Processor

Подготовка исходного изображения:

- разрешение и соотношение сторон;

- яркость, контраст, насыщенность и резкость;

- интерактивный предпросмотр;

- опциональный апскейл.

#### Manual Color & Upscale Panel

Финальная обработка видео:

- коррекция яркости, контраста, насыщенности и резкости;

- порционная обработка кадров для снижения потребления памяти;

- автоматическое уменьшение размера порции при нехватке VRAM;

- опциональный AI-апскейл.

При выборе Disabled / Откл апскейл не выполняется.

### Скачать

Актуальный архив workflow и custom nodes:

https://github.com/neron5480-cell/neron-video-minimax-h3-i2v/releases/latest

В архив входят:

- необходимые custom nodes;

- готовый workflow;

- системный промпт автопромптера;

- двуязычные заметки.

Модели, LoRA и апскейлеры скачиваются отдельно. Ссылки указаны внутри workflow и в документации репозитория.

---

## English

> ## Important Update

> An error was found in the frame-processing calculations of my_turbo_color_fix.py. It could cause increased memory usage and prevent memory from being released correctly. (It caused an out-of-memory error because it sent the entire pool for processing without unloading the models from the video card's memory.)

The issue has been fixed, and the frame-processing and memory-management logic has been reworked.

If you downloaded an earlier version, please download the latest archive, reinstall the custom nodes, and restart ComfyUI.

I apologize for the inconvenience and appreciate your understanding.

### Overview

A ready-to-use ComfyUI workflow for MiniMax H3 Image-to-Video generation.

It includes:

- source image preparation;

- automatic prompt generation;

- manual and automatic camera control;

- 8-step and 20-step generation modes;

- support for up to five LoRAs;

- frame interpolation;

- color correction and AI upscaling.

### How to Use

1. Load the source image.

2. Select the resolution and aspect ratio.

3. Describe the scene in natural language.

4. The auto-prompter will create a technical prompt for MiniMax H3.

5. Adjust the camera manually if needed.

6. Select the 8-step or 20-step generation mode.

7. Connect the required LoRAs.

8. After generation, apply frame interpolation, color correction, or upscaling.

### VRAM Requirements

The workflow can run on GPUs with 8 GB of VRAM.

If available memory is limited:

- reduce the resolution or video duration;

- use the 8-step mode;

- disable optional processing;

- apply AI upscaling after video generation.

### Generation Modes

#### 20 Steps

The main mode, providing more stable color, brightness, and saturation. Additional color correction is usually not required.

#### 8 Steps

A faster mode with lower GPU usage. Longer videos may show gradual changes in color, brightness, or saturation.

Use Manual Color & Upscale Panel to correct the final result when needed.

### Camera and Auto-Prompter

The auto-prompter analyzes the image and converts a natural-language scene description into a technical prompt.

If no camera movement is specified, the camera remains static. When camera movement is requested, the auto-prompter adds direction, distance, angles, and trajectory.

A manual mode is also available and does not require a language model. It allows you to configure:

- shot type;

- camera position and distance;

- camera movement;

- video duration.

The duration must be specified in seconds at the beginning of the prompt. It is used to place timing markers correctly.

### LoRA

The H3 LoRA Selector — 5 Slots node allows you to:

- connect up to five LoRAs;

- enable or disable each slot independently;

- adjust the strength of each LoRA;

- use LoRAs in both 8-step and 20-step modes.

Active LoRAs are applied sequentially from slot 1 to slot 5.

### Image Processing

#### Interactive Image Processor

Used to prepare the source image:

- resolution and aspect ratio adjustment;

- brightness, contrast, saturation, and sharpness controls;

- interactive preview;

- optional upscaling.

#### Manual Color & Upscale Panel

Used for final video processing:

- brightness, contrast, saturation, and sharpness correction;

- chunk-based frame processing to reduce memory usage;

- automatic chunk-size reduction when VRAM is limited;

- optional AI upscaling.

When Disabled / Откл is selected, AI upscaling is not performed.

### Download

Download the latest workflow and custom nodes archive:

https://github.com/neron5480-cell/neron-video-minimax-h3-i2v/releases/latest

The archive includes:

- required custom nodes;

- the ready-to-use workflow;

- the auto-prompter system prompt;

- bilingual workflow notes.

Models, LoRAs, and upscalers are not included. Download links are available inside the workflow and in the repository documentation.