minimax h3本地部署教程 详细图文,电脑硬件要求多少内存 显存

minimax h3本地部署教程 详细图文,电脑硬件要求多少内存 显存

MiniMax H3 是什么？

MiniMax H3 是 MiniMax 于 2026 年 7 月底正式开源的通用多模态视频生成模型，支持文生视频（T2V）、图生视频（I2V）和参考驱动视频（R2V），最高可生成 2K 分辨率、5–15 秒带原生立体声音频的片段。 模型以「开源权重」形式发布，官方推荐的本地推理框架包括 SGLang、vLLM、diffusers 和 ComfyUI，其中 ComfyUI 已提供原生工作流模板和打包模型。

minimax h3模型下载地址：https://feizhuke.com/minimax-xiazai

硬体与系统要求（重要前置条件）

在开始部署前，请确认你的 Windows 电脑符合以下条件，否则可能无法运行或极度缓慢：

• GPU：推荐 NVIDIA 显卡，最低 12GB 显存（8GB 可勉强运行量化版本，但需设置虚拟内存）
• 内存：建议 32GB+，运行时峰值可达 108GB（需设置 100GB+ 虚拟内存）
• 存储：模型文件总计约 42.5GB（ComfyUI 打包版本约 343GB，含全部检查点）
• 系统：Windows 10/11 64 位，需安装最新 NVIDIA 驱动
• ComfyUI：版本 0.30.0 或更高

详细部署步骤（以 ComfyUI 为例）

以下是目前最成熟的本地部署方案，基于官方 ComfyUI 工作流和 Hugging Face 打包模型：

步骤 1：下载并安装 ComfyUI

1. 访问 ComfyUI 官方或可信来源下载 Windows 便携版（Portable）整合包
2. 解压缩到任意位置（例如 D:\ComfyUI_Windows_portable）
3. 首次运行前，双击 update_comfyui.bat（或类似名称）更新到最新版本 0.30.0+

步骤 2：下载 MiniMax H3 模型文件

ComfyUI 已将模型重新打包为单文件 .safetensors 格式，托管在 Hugging Face 的 Comfy-Org/MiniMax-H3 仓库：

• 文生视频/图生视频（FL2VA）检查点：

• minimax_h3_fl2va_pruned_int8_convrot.safetensors（推荐，量化版本，约 21GB）

• minimax_h3_fl2va_int8_convrot.safetensors

• minimax_h3_fl2va_bf16.safetensors（原始精度，更大）

• 参考驱动视频（Ref2VA）检查点：

• minimax_h3_ref2va_pruned_int8_convrot.safetensors

• minimax_h3_ref2va_int8_convrot.safetensors

• minimax_h3_ref2va_bf16.safetensors

• 辅助模型：

• 文本编码器：qwen3vl_32b_minimax_h3_*.safetensors

• VAE：minimax_h3_video_vae_fp16.safetensors、minimax_h3_audio_vae_fp32.safetensors

minimax h3模型下载地址：https://feizhuke.com/minimax-xiazai

• 直接访问  下载所需文件
• 或使用 ComfyUI 内置功能：加载工作流后，弹窗会列出缺失模型并提供一键下载按钮

步骤 3：放置模型文件到正确目录

下载完成后，将文件按以下结构放入 ComfyUI 的 models 目录：

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   ├── minimax_h3_fl2va_pruned_int8_convrot.safetensors
│   │   └── minimax_h3_ref2va_pruned_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │   └── qwen3vl_32b_minimax_h3_*.safetensors
│   └── 📂 vae/
│       ├── minimax_h3_video_vae_fp16.safetensors
│       └── minimax_h3_audio_vae_fp32.safetensors

如果你使用的是整合包，直接将下载的 models 文件夹整体覆盖到 ComfyUI 目录即可（会自动按层级合并）。

步骤 4：加载并运行工作流

1. 启动 ComfyUI（双击 run_nvidia_gpu.bat 或类似启动脚本）
2. 在浏览器中打开 http://127.0.0.1:8188（或提示的本地地址）
3. 点击左侧菜单的 Template Library（模板库） > Video（视频） > 选择任一 MiniMax H3 工作流（如 T2V、I2V 或 R2V）
4. 首次加载时，ComfyUI 会自动检测缺失模型并弹出下载提示，点击确认即可自动下载到正确位置
5. 在工作流界面中：

• 设置视频时长（建议先从 4 秒、8 秒开始测试）
• 设置分辨率（如 720p、1080p，最高 2K）
• 输入提示词（可参考官方示例格式：按时间点写分镜、指定参考图用途、明确锁定元素等）
• 点击 Run（运行） 开始生成

步骤 5：优化与调试

• 内存不足：在 Windows 系统设置中增加虚拟内存至 100GB+（尤其 32GB 以下物理内存的用户）
• 生成速度慢：使用量化版本（int8_convrot 或 pruned_int8_convrot）可显著降低显存占用
• 网络问题：如无法从 Hugging Face 下载，可尝试国内镜像站或第三方整合包（如 B 站 UP 主提供的夸克网盘下载）

替代方案与其他部署方式

除了 ComfyUI，MiniMax 官方还支持以下推理框架：

• SGLang：适合多 GPU 部署，需 4 卡以上，命令示例：

  sglang serve --model-path MiniMaxAI/MiniMax-H3 --num-gpus 4 --ulysses-degree 4 --model-variant fl2va

• vLLM：类似 SGLang，需配置对应的 vLLM 食谱（recipe）
• diffusers：Python 库，可直接通过 ModularPipeline.from_pretrained("MiniMaxAI/MiniMax-H3") 加载，无需手动下载模型

注意事项

• MiniMax H3 并非「完全开源」，而是「开源权重」，商业使用可能有条件限制
• 模型文件总计约 42.5GB（单一任务检查点），完整下载所有版本约 343GB
• 普通家用电脑（如 8GB 显存、16GB 内存）可能无法流畅运行，建议先使用云端服务（如 Runpod、ComfyUI 在线模板）体验
• 官方 API 和 Hailuo AI App 已上线 H3，如本地部署困难，可先通过这些渠道使用

如需进一步优化提示词或工作流设计，可参考官方文档和社区分享的分镜脚本格式。