☰
MiniMax-H3 ComfyUI 部署教程:8GB 显存也能 4 步跑通视频生成
2026/11/4 6:55:14 网站建设 项目流程

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 显卡基本跑不动,建议换硬件
显存8GB16GB 及以上低于 8GB 速度慢,个别任务跑不动
操作系统Windows / Linux,装好 CUDA 驱动与最低要求一致驱动缺失时 CUDA 初始化失败,ComfyUI 起不来
依赖版本PyTorch + 最新版 ComfyUIPyTorch 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 以上显存
I2Vfl2va 系列minimax_h3_fl2va_int8_convrot.safetensorsminimax_h3_fl2va_bf16.safetensors
R2V / T2Vref2va 系列minimax_h3_ref2va_int8_convrot.safetensorsminimax_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.safetensors

embeddings/ 是特效提示词文件,放好后在文本提示里按仓库说明引用即可。打开 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询