企业官网建设流程全解析

MiniMax-H3 ComfyUI 部署排障速查：显存选对档位，一次跑通视频生成

【免费下载链接】MiniMax-H3项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/MiniMax-H3

MiniMax-H3 是可以直接跑在 ComfyUI 里的视频生成模型，文生视频、图生视频、参考图生视频三条路都有。这篇文章写给下好模型文件、却卡在工作流跑不起来的人，专治两大坑：文件放错文件夹、版本超出显存。照下面的顺序自查，能少踩一半的坑。

三个典型翻车现场：先对号入座

节点下拉框里没有模型？

现象：文件放好、重启了，模型节点的下拉框空空如也，或者根本没有新选项。看着像模型文件坏了，其实是路径不对。ComfyUI 只认models/下固定命名的子文件夹，扩散模型放进vae/、文本编码器放进loras/，它都看不见。判断方法：把每个文件的类型和它所在的子文件夹逐一对一遍，放错一层就挪对再重启，立即可选。

加载模型阶段直接 OOM？

现象：加载到一半报错，或显存瞬间打满被系统杀掉。根因就一句：bf16 全精度版本塞进了 8GB 的卡。MiniMax-H3 的显存门槛是 8GB，但 8GB 卡只配得上量化版；bf16建议 24GB 以上再碰。判断方法：看模型文件名后缀，bf16加小于 24GB 显存，基本就是它。

最后一步解码就报错？

现象：前面生成全正常，落到保存视频、音频那一步才崩。看着像生成失败，其实是缺 VAE。视频 VAE 和音频 VAE 各管一路解码，缺任何一个都过不去。判断方法：确认vae/里minimax_h3_video_vae_fp16.safetensors和minimax_h3_audio_vae_fp32.safetensors两个文件都在。

显存不同，该选哪个版本？

🎯 先查表再动手，diffusion 模型和文本编码器各有一档选择：

pruned 和完整版的区别是什么？

pruned后缀是裁剪版，同一精度档位里体积更小、显存占用更低。做对了，8GB 卡刚好有余量；做错了，加载阶段就把显存打爆。24GB 以下的卡，同档位优先拿pruned。

显卡吃紧怎么提速？

loras/里配了 turbo LoRA，比如minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors，挂进工作流采样步数直接砍到 4 步；嫌 4 步粗糙还有 8 步版过渡。低配卡上这是省时间、降显存最直接的招。

落地：下载、放目录、最小文件集

⚠️ 仓库体积不小，别贪全量。12 个 diffusion 模型加 3 个 32B 文本编码器，全下下来磁盘压力很大。先按工作流只留需要的组合：

git clone https://gitcode.com/hf_mirrors/Comfy-Org/MiniMax-H3

再按 README.md 里的目录说明把文件拷进 ComfyUI，子文件夹名必须一字不差：

📂 ComfyUI/ └── 📂 models/ ├── 📂 diffusion_models/ # 12 个扩散模型（fl2va / ref2va 系列） ├── 📂 text_encoders/ # qwen3vl_32b 三个量化档 ├── 📂 loras/ # 3 个 turbo LoRA ├── 📂 vae/ # 视频 VAE + 音频 VAE，缺一不可 ├── 📂 model_patches/ # controlnet 补丁，按需 └── 📂 embeddings/ # 10 个风格词 embedding

跑通一条 I2V 的最小文件集是哪些？

5 个文件，缺一个都白搭：

• diffusion_models/ 下minimax_h3_fl2va_pruned_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
• loras/下minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors

模板不用自己搭节点：官方配套了 I2V、T2V、R2V 工作流模板，在 ComfyUI 工作流面板里直接加载。embeddings/里的风格词在 CLIPTextEncode 节点写embedding:minimaxh3_dark_magic就能调用，文件名换掉就行，省得手打长提示。

报错速查：现象、根因、处理

1. 下拉框为空 / 提示找不到模型→ 文件在错误的子文件夹 → 挪到对应类型目录，重启 ComfyUI。
2. 加载时 OOM→ 显存撑不起 bf16 → 换int8_convrot或fp8_scaled；8GB 卡直接上pruned量化版。
3. int8_convrot 加载失败或报错→ pytorch 不是 cu130 环境 → 退fp8_scaled，兼容性最好，当兜底用。
4. 出片没声音 / 最后一步崩→ 缺音频 VAE → 补上minimax_h3_audio_vae_fp32.safetensors。
5. 自己改过文件名→ 下拉框不认 → 改回仓库原始文件名，文件位置对了也别动名字。

行动清单：先跑通，再补全

1. 按最小文件集放齐 5 个文件，子文件夹逐一对
2. 重启 ComfyUI，确认下拉框能选到扩散模型、文本编码器、两个 VAE 和 LoRA
3. 加载官方 I2V 模板，挂 4 步 turbo LoRA，出第一条片子，确认环境没问题
4. 再按需求补ref2va系列、bf16高精度版和 embeddings 风格词

【免费下载链接】MiniMax-H3项目地址: https://ai.gitcode.com/hf_mirrors/Comfy-Org/MiniMax-H3