Skip to content
Other

MiniMax-H3-MPEG-Diffusion

ускорение генерации видео в 1.94 раза

2 min read

Набор исследовательских весов от разработчика johndpope, реализующий метод MPEG-Diffusion (Mixed-Resolution Video Generation) для видеомодели MiniMax-H3. Технология рендерит весь кадр в половинном разрешении, но выделяет ключевой объект (например, лицо) и прорисовывает его в полном разрешении с помощью механизма dual-resolution attention (внимания двойного разрешения). Такой подход позволяет получать чёткие детали на главном объекте при существенной экономии вычислений без полного файнтюна базового DiT (Diffusion Transformer). Репозиторий пригодится энтузиастам генерации видео, исследователям и пользователям ComfyUI, которые хотят ускорить создание роликов в высоком разрешении.

Ключевые особенности

  • Ускорение почти в два раза: генерация 22-кадрового видео в разрешении 1344×768 проходит в 1.94 раза быстрее стандартного рендера на RTX 5090.
  • Автоматическое выделение объекта: модуль region_head_v3 (линейный слой на 25-м блоке замороженного DiT) сам определяет зону с главным объектом во время сэмплинга.
  • Устранение артефактов сетки: предобученные K/V-карты (kv_maps, ранг 128, 50 блоков) убирают «алмазную» зернистость в области высокого разрешения.
  • Поддержка ComfyUI: веса интегрируются через специальную ноду или CLI-пайплайн проекта scrya-com/mpeg-diffusion.

Что можно сделать

  • Ускорить локальный рендер видео на базе MiniMax-H3 в ComfyUI, подключив kv_maps и region_head_v3 через вход maps в режиме quality.
  • Дообучить собственный LoRA-адаптер (ранг 16) на базе опубликованного пайплайна lot/train_tt_all.sh и готовых текстовых эмбеддингов без запуска 32B-энкодера.

Пример

Запуск рендера в режиме высокого качества через CLI-инструмент из связанного репозитория scrya-com/mpeg-diffusion с использованием kv_maps и region_head_v3 (либо передача папки kv_maps во вход maps соответствующей ноды в ComfyUI): render --preset quality.

ПодробнееСкорость: 1.94× на 22 кадрах 1344×768 (тест на RTX 5090).
Метрики: region_head обучен на 2 354 изображениях с разметкой YOLOE, held-out mIoU — 0.468.
Статус весов: опубликованы kv_maps и region_head_v3; ранг-16 LoRA в репозиторий не включена (исследование в процессе).
Лицензия: MiniMax H3 Community License — использование запрещено в США, ЕС, Великобритании и Южной Корее; требуется маркировка ИИ-контента.
Discuss 1

Will it run?

Runs in 4-bit

Full precision does not fit, a quantised version does: quality barely changes down to 8 bits, more noticeably at 4 bits.

  • BF16weights 62 GB · ready files68 GB
  • FP8 / INT8recommendedweights 31 GB34 GB
  • 4-bitweights 17 GB20 GB

Tip: go 8-bit.FP8 / INT8 is within about a percent of full precision in quality, takes half the memory and runs faster on RTX 40/50 and H100. Full precision only pays off for fine-tuning.

This is a LoRA: counted together with its base model MiniMax-H3.

Estimate: weights plus working memory. Long videos, high resolutions and long contexts need more.

Run it on Massed Compute

A ready script for the machine we advise above: paste it and the model downloads and starts.

  1. 1. Rent RTX A6000

    $0.43 an hour with the coupon. Pick the Ubuntu image when you create the machine.

    Open Massed Compute
  2. 2. Paste the script into the machine's terminal

    Connect over SSH (the Massed Compute panel shows the command) or open a terminal on the machine's desktop.

    HF_TOKEN / CIVITAI_TOKENThe script starts with token lines: paste yours between the quotes. The Hugging Face token is for gated models, the Civitai one for Civitai models.

    #!/usr/bin/env bash
    # MiniMax-H3-MPEG-Diffusion
    set -e
    # NVIDIA driver: CUDA 13 needs 580+. If older or missing, the current nvidia-open is installed (keep yours: KEEP_DRIVER=1)
    DRV=$(nvidia-smi --query-gpu=driver_version --format=csv,noheader 2>/dev/null | head -1 | cut -d. -f1)
    case "$DRV" in ""|*[!0-9]*) DRV=0 ;; esac
    if [ "$DRV" -lt 580 ] && [ -z "${KEEP_DRIVER:-}" ]; then
      . /etc/os-release && \
      curl -fsSLO "https://developer.download.nvidia.com/compute/cuda/repos/ubuntu${VERSION_ID//./}/x86_64/cuda-keyring_1.1-1_all.deb" && \
      sudo dpkg -i cuda-keyring_1.1-1_all.deb && rm -f cuda-keyring_1.1-1_all.deb && \
      sudo apt-get update && \
      sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nvidia-open || \
      { echo "Could not install the NVIDIA driver: see the error above. To keep the current one, run with KEEP_DRIVER=1."; exit 1; }
      echo "NVIDIA driver updated. Reboot the machine (sudo reboot) and run this same script again."
      exit 0
    fi
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    # CUDA 13+ → int8_convrot (Comfy-Org's advice), else fp8_scaled
    CU=$(nvidia-smi | grep -oP 'CUDA Version: \K[0-9]+' || echo 12)
    [ "$CU" -ge 13 ] && TORCH=cu130 || TORCH=cu128
    [ -d ~/ComfyUI ] || git clone https://github.com/comfyanonymous/ComfyUI ~/ComfyUI
    cd ~/ComfyUI
    uv venv --python 3.12 --allow-existing && source .venv/bin/activate
    uv pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/$TORCH
    uv pip install -r requirements.txt "huggingface_hub[cli]"
    # Base files: MiniMax H3, 8-bit
    if [ "$CU" -ge 13 ]; then
      hf download Comfy-Org/MiniMax-H3 diffusion_models/minimax_h3_fl2va_int8_convrot.safetensors text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors vae/minimax_h3_video_vae_fp16.safetensors vae/minimax_h3_audio_vae_fp32.safetensors --local-dir models
    else
      hf download Comfy-Org/MiniMax-H3 diffusion_models/minimax_h3_fl2va_pruned_fp8_scaled.safetensors text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors vae/minimax_h3_video_vae_fp16.safetensors vae/minimax_h3_audio_vae_fp32.safetensors --local-dir models
    fi
    # LoRAs (1)
    hf download johndpope/MiniMax-H3-MPEG-Diffusion kv_maps/up_maps_tt.safetensors --local-dir models/loras/johndpope__MiniMax-H3-MPEG-Diffusion
    # Start ComfyUI. From your computer: ssh -L 8188:localhost:8188 user@IP, then http://localhost:8188
    python main.py --listen 127.0.0.1 --port 8188
    Add more LoRAs to MiniMax-H3
  3. 3. Use it

    From your computer: ssh -L 8188:localhost:8188 user@machine-IP, then open http://localhost:8188. Or open that address in the browser on the machine's desktop. The model's workflow is usually in its Hugging Face card.

Stop the machine in the panel when you are done: it bills by the minute while it runs.

How to speed it up

Picked for this model type. Choose your hardware above to see what fits you exactly.

  • FlashAttention 44.0.0b40from November 18, 2026new release

    fastest exact attention on B200

    Kernels for Blackwell (beta). Exact attention without quantisation — fine for everything, LLMs included.

    How to enable: pip install flash-attn-4; vLLM and SGLang pick it up themselves.

    Earlier generations (2)
    • FlashAttention 3 — The Hopper (H100/H200) version with FP8.
    • FlashAttention 2 — The standard for RTX 30/40/50 and A100: exact attention without the memory cost of long contexts.
  • torch.compile2.15.0from October 28, 2026new release

    10–30% for free

    Compiles the model for your GPU. Slower first run, faster afterwards.

    How to enable: model = torch.compile(model); in ComfyUI the TorchCompileModel node.

MiniMax H3 prompts

All prompts

Ready prompts with the resulting video: copy and try.

Model family

Requires the base model

MiniMaxAI/MiniMax-H3

This model is a LoRA / adapter. Download the base model first, then load this one on top.

New posts about versions of MiniMax-H3 (quants, finetunes, LoRAs) will show up under the bell.

Quantised versions 12All on Hugging Face
Fine-tunes 12All on Hugging Face
LoRAs and adapters 12All on Hugging Face
Merges 3All on Hugging Face

About the model

johndpope/MiniMax-H3-MPEG-Diffusion
Author
johndpope
Category
Other
Released
Posted

On NeyroLearn

Hugging Face

01

Ask AI about this model

Answered by Gemini 4 · the chat is kept only in this tab

Comments