MiniMax H3 ComfyUI 部署指南

简介

MiniMax H3 是 MiniMax 推出的全模态视频生成模型，支持文生视频（T2V）、图生视频（I2V），生成的视频自带原生立体声音频（语音、音效、音乐同步生成）。ComfyUI 从 v0.30.0 开始原生支持，无需安装额外自定义节点。

硬件要求

需要下载的模型文件

以下文件均来自 ModelScope 国内镜像（速度快、稳定），仓库为 Comfy-Org/MiniMax-H3。

1. Diffusion 主模型（FL2VA 通用版）

• 文件名： minimax_h3_fl2va_pruned_int8_convrot.safetensors

• 大小： ~19.5 GB

• 放置目录： ComfyUI/models/diffusion_models/

• 下载链接：

  https://modelscope.cn/models/Comfy-Org/MiniMax-H3/resolve/master/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors
  

用于文生视频（T2V）和图生视频（I2V），是最常用的基础版本。

2. 文本编码器

• 文件名： qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors

• 大小： ~14.6 GB

• 放置目录： ComfyUI/models/text_encoders/

• 下载链接：

  https://modelscope.cn/models/Comfy-Org/MiniMax-H3/resolve/master/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
  

所有工作流（T2V / I2V / R2V）都共用这一个文本编码器。

3. 视频 VAE

• 文件名： minimax_h3_video_vae_int8_convrot.safetensors

• 大小： ~2.6 GB

• 放置目录： ComfyUI/models/vae/

• 下载链接：

  https://modelscope.cn/models/Comfy-Org/MiniMax-H3/resolve/master/vae/minimax_h3_video_vae_int8_convrot.safetensors
  

4. 音频 VAE

• 文件名： minimax_h3_audio_vae_fp32.safetensors

• 大小： ~0.6 GB

• 放置目录： ComfyUI/models/vae/

• 下载链接：

  https://modelscope.cn/models/Comfy-Org/MiniMax-H3/resolve/master/vae/minimax_h3_audio_vae_fp32.safetensors
  

5. Turbo 加速 LoRA（可选）

• 文件名： minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors

• 大小： ~1.8 GB

• 放置目录： ComfyUI/models/loras/

• 下载链接：

  https://modelscope.cn/models/Comfy-Org/MiniMax-H3/resolve/master/loras/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors
  

可选安装。启用后可从 20 步加速到 8 步生成，速度提升约 2 倍，音频和运动质量略有下降。

文件目录结构总览

下载完成后，你的 ComfyUI models 目录应该长这样：

ComfyUI/
└── models/
    ├── diffusion_models/
    │   └── minimax_h3_fl2va_pruned_int8_convrot.safetensors
    ├── text_encoders/
    │   └── qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
    ├── vae/
    │   ├── minimax_h3_video_vae_int8_convrot.safetensors
    │   └── minimax_h3_audio_vae_fp32.safetensors
    └── loras/
        └── minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors

总计约 39 GB

快速开始

方式一：通过 ComfyUI 模板库（推荐）

1. 启动 ComfyUI（确保版本 ≥ v0.30.0）

2. 打开左侧 Template Library（模板库）

3. 选择 Video 分类

4. 找到并打开 MiniMax H3 T2V（文生视频）或 MiniMax H3 I2V（图生视频）

5. 模型会自动加载，直接输入提示词点运行即可

方式二：手动导入工作流

从官方下载工作流 JSON 文件，拖入 ComfyUI 界面即可：

• T2V 工作流：https://docs.comfy.org/zh/tutorials/video/minimax/minimax-h3-native

• I2V 工作流：同上页面

• R2V 工作流：同上页面

关键参数说明

提示词技巧

1. 描述整个场景：先写整体场景（地点、角色、正在发生什么），再按时间拆分镜头

2. 镜头 + 音频写在一起：在同一个提示词块里描述相机运动、对白、音效、音乐

3. 中英文都支持：中文提示词效果不错，复杂镜头建议用英文

4. I2V 关键帧：把图片连到 first_frame 和/或 last_frame 节点即可

常见问题

Q：模型放对了但 ComfyUI 里找不到？

A：重启 ComfyUI，让它重新扫描模型目录。或者点节点上的刷新按钮。

Q：显存不够怎么办？

A：确保用的是 pruned_int8_convrot 版本（剪枝 + INT8 量化），这是显存最友好的版本。ComfyUI 会自动做动态显存卸载。

Q：R2V（参考生视频）需要另外下载模型吗？

A：是的。R2V 使用独立的 minimax_h3_ref2va_pruned_int8_convrot.safetensors，和 T2V/I2V 的 FL2VA 模型不能通用。

Q：下载太慢怎么办？

A：用 ModelScope 国内镜像（本指南的链接都是国内源），或者用 IDM、aria2 等多线程下载工具。

备用下载源

如果 ModelScope 访问不了，可以用 Hugging Face 镜像：

• Hugging Face 仓库： Comfy-Org/MiniMax-H3

• HF 直链格式： https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/<文件路径>

• 国内 HF 镜像： https://hf-mirror.com/Comfy-Org/MiniMax-H3/resolve/main/<文件路径>

商业使用

本地生成的输出如果用于商业用途，需要获取 MiniMax 的商业授权。Comfy Cloud 上生成的内容已包含商业权利。