如何下载并运行
本地运行 MiniMax H3
在官方 Hugging Face 或 ModelScope 仓库中查找 MiniMax H3 开源多模态权重。如果你搜索“MiniMax H3 GitHub”，请注意模型权重与 Comfy-Org 工作流模板位于不同仓库。关于 MiniMax H3 API 或 2K 输出，请先核对文档中的 H3-Regenerate-2K/API 辅助路径，再选择运行时。查看不同运行时的兼容性说明，并按照所选运行时的文档化本地部署路径操作。
先从任务选择，而不是从检查点选择。
| 用户目标 | 使用路径 | 推荐路径 |
|---|---|---|
| 文生视频 | FL2VA | 官方 H3-Base FL2VA 检查点 |
| 首帧 / 尾帧视频 | FL2VA | 官方 FL2VA 工作流中的一张或两张图像输入 |
| 图像、视频或音频参考 | Ref2VA | 官方 H3-Base Ref2VA 检查点 |
| 普通 ComfyUI 用户 | ComfyUI | Comfy-Org INT8 扩散模型 + NVFP4 文本编码器 + VAE 文件 |
| 多 GPU 服务器 | BF16 | 使用 SGLang 或 vLLM 的官方 H3-Base 检查点 |
| 完整 2K 输出 | Hybrid | 本地 H3-Base 加托管式 H3-Regenerate-2K/API 路径 |
官方下载仓库
Hugging Face 仓库
官方 H3 模型文件、文档和不同运行时的下载变体。
ModelScope 仓库
面向亚洲和中国大陆用户的高速下载镜像。
ComfyUI 集成
H3 官方原生 ComfyUI 工作流、模型文件夹和本地设置说明。
硬件与显存要求
| 硬件参数 | 官方基线 | 实用说明 |
|---|---|---|
| GPU 型号 | 没有公布统一最低要求 | 核对所选运行时、模型变体、分辨率和卸载行为。 |
| 显存（VRAM） | 没有公布统一最低要求 | 不要仅凭显存推断本地 2K 支持。 |
| 系统内存 | 取决于运行时 | 遵循所选运行时当前的要求。 |
| 磁盘空间 | 取决于模型变体 | 下载前查看所选仓库的文件大小。 |
| 操作系统 | 取决于运行时 | 使用该运行时文档记录的操作系统与 CUDA/PyTorch 组合。 |
本地 CLI 分步安装
官方模型卡提供了真实可用的 hf download 路径，用于下载原始 H3-Base 检查点系列。SGLang/vLLM 用户选择其中一条命令；ComfyUI 用户应使用下面列出的独立优化文件。
# Install the official Hugging Face CLI if needed python -m pip install -U huggingface_hub # Full H3-Base FL2VA + Ref2VA checkpoint families hf download MiniMaxAI/MiniMax-H3 --include "model_index.json" "modular_model_index.json" "FL2VA/*" "Ref2VA/*" --local-dir MiniMax-H3 # FL2VA only: text-to-video and first/last-frame workflows hf download MiniMaxAI/MiniMax-H3 --include "model_index.json" "modular_model_index.json" "FL2VA/*" --local-dir MiniMax-H3
ComfyUI 扩散模型
minimax_h3_fl2va_pruned_int8_convrot.safetensorsminimax_h3_ref2va_pruned_int8_convrot.safetensorsmodels/diffusion_models/
ComfyUI 文本编码器
qwen3vl_32b_minimax_h3_nvfp4_awq.safetensorsmodels/text_encoders/
ComfyUI VAE
minimax_h3_video_vae_fp16.safetensorsminimax_h3_audio_vae_fp32.safetensorsmodels/vae/
BF16 H3-Base 下载内容和 ComfyUI INT8/NVFP4 软件包服务于不同运行时。请分开保存模型目录，并遵循模板中的准确文件名。
常见问题
有官方 MiniMax H3 GGUF 版本吗？
截至 2026 年 8 月，MiniMax 尚未为 H3 视频生成发布官方 GGUF 量化模型。请警惕网上的虚假 GGUF 文件，使用官方 Hugging Face 或 ModelScope 权重。
MiniMax H3 模型权重总下载大小是多少？
官方仓库包含多个运行时和精度变体，因此没有一个可靠的统一下载大小。请查看计划使用的具体变体的文件大小。
MiniMax H3 能在 Apple Silicon Mac（M1/M2/M3 Max）上运行吗？
没有官方 H3 来源确认 Apple Silicon 或 PyTorch MPS 支持。请将 Mac 推理视为未核验，并在投入硬件资源前遵循受支持运行时的文档。
MiniMax H3 的本地性能与 Hailuo H3 或 Seedance 2.5 相比如何？
H3 支持统一多模态上下文和原生立体声音频。本指南没有与其他视频管线进行受控的本地基准测试，因此不要假设其速度或质量更优。