MiniMax-H3 ComfyUI 部署教程:8GB 显存也能 4 步跑通视频生成
【免费下载链接】MiniMax-H3项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/MiniMax-H3
MiniMax-H3 是一套给 ComfyUI 用的视频生成模型,支持文字生视频、首帧图生视频、参考主体生视频三类任务(带音频)。本文按「检查硬件 → 选文件 → 放文件启动 → 排错」的顺序走。你照着逐项核对,就能完成部署。
🖥️ 部署前环境检查
结论先行:NVIDIA RTX 系列、8GB 显存是稳妥线。低于 8GB 模型能加载,但生成速度明显变慢,个别任务直接跑不动;显卡不是 NVIDIA,建议先换硬件。
| 检查项 | 最低要求 | 推荐配置 | 不满足会怎样 |
|---|---|---|---|
| GPU 型号 | NVIDIA RTX 系列(支持 CUDA) | RTX 40 / 50 系列 | 非 NVIDIA 显卡基本跑不动,建议换硬件 |
| 显存 | 8GB | 16GB 及以上 | 低于 8GB 速度慢,个别任务跑不动 |
| 操作系统 | Windows / Linux,装好 CUDA 驱动 | 与最低要求一致 | 驱动缺失时 CUDA 初始化失败,ComfyUI 起不来 |
| 依赖版本 | PyTorch + 最新版 ComfyUI | PyTorch cu130 | 没有 cu130 就用不了 int8_convrot,得退回 fp8_scaled |
如果硬件不达标,最优先解决显存——换压缩精度文件,是最有效且零成本的手段。
📂 模型文件怎么选
一句话规则:先定任务,再看显存,最后定精度。同一前缀的文件是同一任务的不同版本。
你可能要做的三类任务:
- T2V(文字生视频):只输入文字描述,直接生成视频。
- I2V(首帧图生视频):给一张首帧图,生成带动画和音频的视频。
- R2V(参考主体生视频):用一张参考图作为主体来生成视频。
文件名里的常见缩写:
- fl2va:首帧图带音频(first frame + audio)生成视频,对应 I2V 任务
- ref2va:参考主体(reference)生成视频,对应 R2V 和 T2V 任务
- bf16:原始精度,画质最好,占显存最大
- int8:8 位整数量化,显存占用明显降低
- fp8:8 位浮点量化,显存占用接近 int8
- pruned:同任务的轻量版,参数更小,更省显存
再对着选文件:
| 你要做的任务 | 扩散模型选哪类 | 8–12GB 显存 | 16GB 以上显存 |
|---|---|---|---|
| I2V | fl2va 系列 | minimax_h3_fl2va_int8_convrot.safetensors | minimax_h3_fl2va_bf16.safetensors |
| R2V / T2V | ref2va 系列 | minimax_h3_ref2va_int8_convrot.safetensors | minimax_h3_ref2va_bf16.safetensors |
int8_convrot 版本需要 PyTorch cu130。环境不满足时,改用 fp8_scaled 版本。选完精度还紧张,就在文件名前加 pruned 换轻量版。仓库 loras/ 里还有 turbo 加速版,能减少生成步数,按需加载。
别忘把文本编码器和 VAE 一起放齐,缺一工作流加载不出来。文本编码器也可换 int8 版省显存。
🚀 放置文件并首次启动
放置规则一句话:每个文件放进 ComfyUI 的 models/ 下对应子文件夹,放错一层就不认。
git clone https://gitcode.com/hf_mirrors/Comfy-Org/MiniMax-H3克隆完成后,仓库子文件夹与下面目录树一一对应,把文件拷进 models/ 的同名文件夹即可对号入座。
📂 ComfyUI/ ├── 📂 models/ │ ├── 📂 diffusion_models/ │ │ ├── minimax_h3_fl2va_bf16.safetensors │ │ ├── minimax_h3_fl2va_int8_convrot.safetensors │ │ ├── minimax_h3_fl2va_pruned_bf16.safetensors │ │ ├── minimax_h3_fl2va_pruned_fp8_scaled.safetensors │ │ ├── minimax_h3_fl2va_pruned_int8_convrot.safetensors │ │ ├── minimax_h3_fl2va_pruned_w6a8.safetensors │ │ ├── minimax_h3_ref2va_bf16.safetensors │ │ ├── minimax_h3_ref2va_int8_convrot.safetensors │ │ ├── minimax_h3_ref2va_pruned_bf16.safetensors │ │ ├── minimax_h3_ref2va_pruned_fp8_scaled.safetensors │ │ ├── minimax_h3_ref2va_pruned_int8_convrot.safetensors │ │ └── minimax_h3_ref2va_pruned_w6a8.safetensors │ ├── 📂 text_encoders/ │ │ ├── qwen3vl_32b_minimax_h3_bf16.safetensors │ │ ├── qwen3vl_32b_minimax_h3_int8_convrot.safetensors │ │ └── qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors │ ├── 📂 loras/ │ │ ├── minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors │ │ ├── minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors │ │ └── minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors │ ├── 📂 model_patches/ │ │ ├── minimax_h3_fun_controlnet_union_pruned_bf16.safetensors │ │ ├── minimax_h3_fun_controlnet_union_pruned_int8_convrot.safetensors │ │ ├── minimax_h3_fun_controlnet_union_2.0_pruned_bf16.safetensors │ │ └── minimax_h3_fun_controlnet_union_2.0_pruned_int8_convrot.safetensors │ ├── 📂 embeddings/ │ │ ├── minimaxh3_art_is_explosion.safetensors │ │ ├── minimaxh3_blooming_flowers.safetensors │ │ ├── minimaxh3_bullet_time.safetensors │ │ ├── minimaxh3_dark_magic.safetensors │ │ ├── minimaxh3_fire_breath.safetensors │ │ ├── minimaxh3_four_seasons.safetensors │ │ ├── minimaxh3_kiss_camera.safetensors │ │ ├── minimaxh3_spiral_ascent.safetensors │ │ ├── minimaxh3_storm_magic.safetensors │ │ └── minimaxh3_truman_show.safetensors │ └── 📂 vae/ │ ├── minimax_h3_audio_vae_fp32.safetensors │ ├── minimax_h3_video_vae_fp16.safetensors │ └── minimax_h3_video_vae_int8_convrot.safetensorsembeddings/ 是特效提示词文件,放好后在文本提示里按仓库说明引用即可。打开 ComfyUI 后,按需求挑模板:
- MiniMax H3: Image to Video:单张首帧图生成视频(带音频)
- MiniMax H3: Text to Video:纯文字描述生成视频
- MiniMax H3: Reference to Video:参考图作主体生成视频
- Image to Video(续写):从已有视频末帧继续生成
- Multiframe Reference:多张参考帧共同控制生成结果
- Fun ControlNet Union:加姿态、边缘控制,需同时加载 model_patches 文件
把扩散模型、文本编码器、VAE 分别对上对应文件,就能开始生成。
⚠️ 常见问题速查
问题基本分三类:显存不足、文件放错、文件缺件。对着表格查:
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| OOM(out of memory)或生成起不来 | 显存不足 | 按顺序降档,方法可叠加:① 换 int8 / fp8 低精度文件,文本编码器也可换 int8 版;② 降低输入分辨率;③ 关掉其他占显存程序(浏览器、另一个 ComfyUI 实例) |
| 模型不识别、列表里看不到文件 | 文件放错了层级 | 移到 models/ 下对应子文件夹,如扩散模型进 diffusion_models/ |
| 工作流加载失败 | 扩散模型、文本编码器或 VAE 缺一类,对不上号 | 逐个核对三类文件,补齐后重新对号入座 |
哪一步卡住了,先查仓库说明 README.md。掌握这套「任务前缀 + 精度后缀」的命名规则后,同类模型仓库也能自行放置。
【免费下载链接】MiniMax-H3项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/MiniMax-H3
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考