MiniMax H3（H3-Base）本地部署保姆级完整教程

 适配 Windows 个人显卡、Linux 服务器，分为硬件门槛、模型版本选择、ComfyUI 可视化部署（新手首选）、命令行 SGLang 企业部署、2K 成片组合方案、常见报错解决，直接落地使用。

重要说明：本次开源仅H3-Base 基座可本地部署，输出 768P 原生音视频；H3-Context-IR 精准指令模块、H3-Regenerate-2K 超分模块无开源权重，想要 2K 分辨率成片，需要本地模型 + MiniMax 官方 API 联动。

一、前置硬件 & 系统门槛（必看，避免直接爆显存 OOM）

1. 显卡显存分级适配

显卡显存	可用模型版本	生成效果	适用人群
8GB VRAM	INT8 量化精简版	768P 短片段（3–5s），画质小幅压缩	入门体验、测试玩法
16GB VRAM	INT8/FP8 量化版	768P 常规短视频（5–10s）稳定运行	主流创作者、自媒体
24GB+ VRAM（4090/A10）	BF16 原生完整版	满画质 768P、长镜头、角色锁定	工作室、重度创作
4 卡 80G A100	BF16 多卡并行	批量推理、企业私有化服务	算法团队、云端服务

2. 配套硬性要求

系统内存：最低 32GB DDR4/DDR5，64GB 为最优，模型加载会占用大量内存；

硬盘：NVMe 高速固态，模型完整包约130GB，量化版 60–80GB，禁止机械硬盘存放；

系统：Windows10/11（NVIDIA 显卡 CUDA12.1+）、Ubuntu22.04（服务器部署）；AMD 显卡支持 ROCm，但兼容性弱于 N 卡。

3.模型两个核心分支选择（按需下载，不用全下）

FL2VA（主推）

：文生视频、首尾帧图生视频，日常短视频、剧情生成首选；

Ref2VA

：参考视频动作迁移、人物形象锁定、镜头复刻，数字人、二创专用。

精度区别：

BF16 原版：画质拉满，显存占用最高；

INT8 量化：显存减半，画质损耗极小，个人电脑首选；

FP8 量化：显存更低，适合低配显卡极限运行。

二、方案一：ComfyUI 可视化部署（新手零代码，推荐）

适合普通创作者，可视化节点拖拽，自带官方文生视频 / 图生视频 / 参考视频工作流。

步骤 1：准备 ComfyUI 环境

下载整合版 ComfyUI 一键启动包，解压到纯英文路径（不要中文文件夹）；

运行run_nvidia_gpu.bat启动，打开浏览器访问http://127.0.0.1:8188，确认基础环境正常；

将 ComfyUI 更新至0.30.0 及以上版本，旧版本无 H3 原生节点支持。

步骤 2：下载 H3 模型权重（两种渠道）

渠道 1：HuggingFace 命令行下载（完整原版）

打开 CMD，安装下载工具

bash

pipinstall-Uhuggingface_hub

只下载FL2VA（日常够用）hf download MiniMaxAI/MiniMax-H3--include"FL2VA/""model_index.json"--local-dir MiniMax-H3-FL2VA# 如需Ref2VA参考模型执行这条hf download MiniMaxAI/MiniMax-H3--include"Ref2VA/""model_index.json"--local-dir MiniMax-H3-Ref2VA

渠道 2：社区量化精简包（低配显卡首选）

直接下载 ComfyUI 适配量化权重：minimax_h3_fl2va_pruned_int8_convrot.safetensors、minimax_h3_ref2va_pruned_int8_convrot.safetensors

步骤 3：模型文件夹归类放置

打开 ComfyUI 根目录，按路径放入文件：

plaintext

ComfyUI/├─ models/│  ├─ diffusion_models/

主模型权重放入此处│  ├─ text_encoders/       # Qwen3-VL文本编码器│  ├─ vae/                 # video_vae视频解码器、audio_vae音频解码器

懒人技巧：新建extra_model_paths.yaml，填写模型外置路径，不用复制大文件到 ComfyUI 目录，节省磁盘空间。

步骤 4：加载官方工作流直接出片

打开 ComfyUI 顶部「Template Library」→「Video」→选择：

节点自动绑定 H3 模型，设置分辨率1280×768（16:9）、视频时长 4–10 秒；

正面提示词示例：城市雨夜街道，汽车驶过灯光拖影，电影运镜，原生立体声环境雨声，画面流畅，人物细节清晰负面提示词：画面撕裂、口型错位、模糊、水印、画面闪烁、音画不同步

点击队列运行，成品视频保存在ComfyUI/output文件夹，自带画面 + 合成立体声 MP4。

三、方案二：SGLang 命令行部署（服务器批量推理、API 服务）

面向企业、算法开发者，搭建后端推理接口，支持批量生成、多卡并行。

1. 环境依赖安装

bash

pip install sglang torch torchvision torchaudio transformers accelerate

2. 启动 FL2VA 文生视频推理服务

bash

sglang serve\--model-path MiniMaxAI/MiniMax-H3\--model-variant fl2va\--host0.0.0.0\--port30010\--performance-mode speed

3. Ref2VA 参考视频服务启动

bash

sglang serve\--model-path MiniMaxAI/MiniMax-H3\--model-variant ref2va\--host0.0.0.0\--port30011

启动后通过 HTTP 接口调用生成视频，可对接自有剪辑平台、数字人系统。

四、实现 2K 高清成片完整工作流（本地 H3-Base + 官方 API 组合）

本地 H3-Base 仅输出 768P，想要文章提到的2K@24fps 高清视频组合方案：

本地 ComfyUI 用 H3-Base 生成 768P 基础音视频（画面、口型、音效全部定型）；

前往 MiniMax 开放平台（platform.minimaxi.com）注册账号，获取 API Key；

调用H3-Regenerate-2K超分 API，上传本地成片做画质升级，无损放大至 2K 分辨率；优势：保留本地创作素材隐私，同时拿到官方顶级超分画质，适合商业宣传片、广告视频。

五、显存优化技巧（低配显卡必用）

启用模型量化：直接使用 INT8/FP8 权重，显存直接降低 40%–50%；

CPU 内存卸载：ComfyUI 开启model_cpu_offload，闲置模型权重放入内存；

缩短生成时长：优先生成 5 秒以内短视频，避免超长视频迭代爆显存；

分辨率锁定：固定 768P，不要强行拉高分辨率推理；

启用 Turbo 加速 LoRA：社区加速 LoRA 可将生成步数从 12 步压缩至 4 步，速度提升 40%。

六、高频报错 & 解决方法

报错：CUDA out of memory（显存溢出）

解决：更换 INT8 量化模型、缩短视频时长、开启模型 CPU 卸载、关闭显卡其他占用程序。

ComfyUI 无 H3 模型节点

解决：升级 ComfyUI 到最新版，检查模型文件夹路径是否正确，重启程序。

生成视频音画不同步

解决：使用官方原版工作流，不要自定义修改 VAE 音频解码节点，H3 音视频是联合生成，改动解码器会破坏同步。

模型下载中断

解决：魔搭 ModelScope 国内镜像下载，速度更稳定，断点续传。

七、商用授权补充

个人非商用：H3-Base 开源模型完全免费使用、二次微调；

企业商用：主体年收入超过 2000 万美金，需要向 MiniMax 官方申请商业授权；

私有化部署企业：仅本地 H3-Base 无授权费用，调用 2K 超分 API 按平台按量计费。