MiniMax H3 本地部署完整教程MiniMax H3 视频生成 - 小白极简教程纯小白不想搞复杂的配置

MiniMax H3 本地部署完整教程

MiniMax H3 视频生成 - 小白极简教程

纯小白不想搞复杂的配置？直接用一键整合包，解压即用。

📦 一键整合包

下载地址： 整合包分享

使用步骤（三步搞定）

1. 下载整合包全部文件
2. 解压后，双击 启动.bat
3. 等待出现本地浏览器 WebUI 界面（http://127.0.0.1:8188），上传素材和提示词即可生成

⚠️ 文件路径不要有中文！建议解压到 D:\MinimaxH3 这样的纯英文路径。

✍️ 提示词撰写

MiniMax H3 非常依赖提示词，它遵循的是一套严格的提示词语法，而不是散文式描述。
💡 直接把这套规范发给 AI，让 AI 帮你写提示词！

提示词规范参考： 提示词规范分享

MiniMax H3 分辨率设置 864 x 480 抽卡试错 确认效果后，再用 1.0 MP（720p）1344 x 768跑最终高清版

各显存可跑配置表如下

📋 目录

1. 准备工作与环境要求
2. 解压与启动
3. 提示词撰写规范
4. 分辨率与抽卡策略
5. 各显存配置参考
6. 常见报错排查

一、准备工作与环境要求

1.1 硬件最低门槛

组件	最低要求	推荐配置
GPU	RTX 3060 (12GB)	RTX 4090 (24GB)
系统内存	32GB	64GB+
磁盘空间	150GB+ (模型文件)	200GB+ SSD
操作系统	Windows 10/11	Windows 11

H3 全精度 BF16 需要服务器级硬件（8×141GB 显存），个人用户请使用量化版。NF4 量化方案可将显存需求降至 6-8GB，RTX 3060 级别即可运行基础功能。

1.2 关键前提

• 文件路径不要有中文（如 D:\MinimaxH3 而非 D:\最强AI视频生成）
• ComfyUI 版本 ≥ 0.30.0，H3 原生节点从该版本开始支持

二、解压与启动

2.1 下载分卷文件

• 下载整个文件夹下所有分卷文件（.7z.001、.7z.002 等）
• 确保所有分卷在同一目录，不要改名

2.2 使用 7-Zip 解压

1. 安装
2. 右键点击 .7z.001 → 7-Zip → 提取到当前位置
3. ⚠️ 不要用 WinRAR 或系统自带解压，处理大文件分卷时易报 数据错误

报错对照：

• 若出现 数据错误: ...qwen3vl_32b_minimax_h3_nvfp4_aqw.safetensors → 文件损坏，换 7-Zip 重解压，仍报错则重新下载该分卷

2.3 启动 WebUI

1. 解压后进入文件夹，双击 启动.bat
2. 等待出现本地浏览器界面：http://127.0.0.1:8188
3. 首次启动加载模型约需 3-5 分钟（冷启动），不要重复点击

三、提示词撰写规范

H3 不是"描述画面"，而是"编排视频"。提示词是 结构化控制文档，不是散文式描述。

3.1 整体公式

完整提示词 = 参考素材说明 + 核心创意 + 画面过程说明

3.2 参考素材说明

按上传顺序写清素材编号和用途：

@图片1 提供了角色形象参考
@视频2 提供了动作参考
@音频1 作为目标视频的音频复刻素材，歌词内容为："ABCDEFGHIJKLMN"

没有上传素材时整段跳过。

3.3 核心创意（一句话锁定全片）

必须包含：主体 + 地点 + 事件 + 题材/风格

一位穿汉服的年轻女子（@图片1）在樱花纷飞的庭院里舞剑，古典国风，电影质感，一镜到底。

3.4 画面过程说明

按时间轴分段，每个分镜包含：

• 景别 + 具体内容 + 运镜 + 动作 + 台词 + 音效

【分镜1】中景，女子缓缓拔剑，镜头从剑尖特写拉至全身，无台词，风声渐起。
【分镜2】全景，女子旋身舞剑，环绕运镜（truck left + pan right），持续3秒...

环绕运镜建议用 truck left + pan right 或 truck right + pan left，而非直接说"环绕运镜"。

四、分辨率与抽卡策略

4.1 两步走策略（强烈推荐）

阶段	分辨率	像素量	用途
抽卡试错	864×480 (480p)	~0.4MP	快速验证构图、动作、运镜、提示词
最终成片	1344×768 (768p)	~1.0MP	获得最佳细节、纹理、文字清晰度

4.2 核心参数

参数	480p 抽卡	768p 成片
采样器	res_multistep	res_multistep
调度器	simple	simple
去噪步数	4-8 步	20 步
引导系数 Guidance	必须为 1	必须为 1
视频偏移	12	12

⚠️ Guidance Scale 必须固定为 1，提高会破坏画面，导致边缘硬化或运动失稳。

4.3 为何这样配置

• 768p 像素量是 480p 的 2.5 倍，但耗时是 3-5 倍
• 480p 足够判断构图、运动、一致性等核心问题
• 大量抽卡节省的时间可投入创意迭代

五、各显存配置参考

5.1 显卡档次与推荐方案

显存	推荐显卡	推荐量化版本	运行表现
8GB	RTX 4060	Q3/Q2 混合精度	最低起跑线，需 32GB+ 内存 + NVMe SSD
12GB	RTX 3060/4070 Ti	Pruned INT8 + NVFP4	推荐入门配置，5秒480p约需5分钟
16GB	RTX 4080	Q5/Q4	兼顾画质与速度
24GB+	RTX 3090/4090	INT8 / NVFP4	最高画质，可流畅运行较高分辨率

5.2 模型文件清单

放置目录结构：

ComfyUI/models/
├── diffusion_models/
│   ├── minimax_h3_fl2va_pruned_int8_convrot.safetensors   # T2V/I2V 用
│   └── minimax_h3_ref2va_pruned_int8_convrot.safetensors  # R2V 用 (~19.5GB)
├── text_encoders/
│   └── qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors      # 两种模式共用
└── vae/
    ├── minimax_h3_video_vae_fp16.safetensors
    └── minimax_h3_audio_vae_fp32.safetensors

六、常见报错排查

6.1 解压报错：数据错误

症状：数据错误: ...qwen3vl_32b...safetensors

根因：解压软件不兼容或分卷下载损坏

修复：

1. 换 7-Zip 重新解压 .7z.001
2. 仍报错则重新下载损坏的分卷（通常只需重下 .001 或 .002）

6.2 启动崩溃：access violation / mmap 读取失败

症状：加载 text encoder 时 ComfyUI 进程崩溃，日志出现 access violation

根因：ComfyUI 用 safetensors.safe_open() 默认 mmap 读取 >10GB 文件，在 Windows 长进程中会触发 access violation，与显存无关。

修复：

1. 启动加 --disable-mmap 参数
2. 降级 safetensors：pip install safetensors==0.7.0
3. 启动加 --lowvram（按需加载/卸载，编码完即释放）

6.3 页面文件太小 (os error 1455)

症状：页面文件太小，无法完成操作。 (os error 1455)

根因：Windows 页面文件不足以承载多个大模型同时加载

修复（管理员运行 PowerShell，重启生效）：

Set-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management' -Name PagingFiles -Value @('C:\pagefile.sys 16384 24576') -Type MultiString

6.4 comfy-kitchen 版本不兼容

症状：'NoneType' object has no attribute 'Params' 或 cannot import name 'TensorCoreConvRotW4A4Layout'

修复：pip install comfy-kitchen==0.2.28

6.5 SaveVideo 节点报错

症状：SaveVideo.execute() missing 1 required positional argument: 'codec'

修复：SaveVideo 节点传入 codec: "auto"（ComfyUI 0.31 必填）

6.6 GGUF 加载报 state_dict mismatch

症状：size mismatch for model.layers.0.input_layernorm.weight: shape torch.Size([5120]) vs torch.Size([4096])

根因：加载器识别为 Qwen3-VL-8B 而非 H3 的 32B 版本

修复：

1. 使用 H3 Clip Loader (Any) 节点（来自 ComfyUI-H3-Multishot）
2. 将 Type 设置为 minimax，而非 qwen3vl
3. 确保 ComfyUI ≥ 0.30.0

6.7 生成纯噪点/马赛克

症状：输出画面为纯噪点或花屏

根因：VAE 被部分卸载导致权重损坏，常见于 AMD 显卡或显存紧张场景

修复：启动加 --disable-smart-memory --cache-none，禁用部分卸载机制

七、快速检查清单

• 文件路径无中文
• 使用 7-Zip 解压 .7z.001，非 WinRAR
• 启动加了 --disable-mmap 参数
• 启动加了 --lowvram 参数（32GB 内存以下）
• 页面文件 ≥ 16GB
• comfy-kitchen 版本 ≥ 0.2.28
• Guidance Scale = 1（固定）
• 抽卡用 864×480，定稿用 1344×768
• SaveVideo 节点传 codec: "auto"