DaSiWa-MiniMax-H3-Hybrid 是基于 MiniMax H3 视频生成模型的蒸馏（Distilled）权重镜像，提供 4 步与 8 步两个 turbo 版本，可在 ComfyUI 中实现文生视频、图生视频、首尾帧视频及音视频同步生成。本指南为你梳理本地部署的显存/硬件需求，并给出一整套"显存不够"时的优化技巧与推荐采样参数，新手也能照着配置跑起来。

🎬 先搞清楚：DaSiWa-MiniMax-H3-Hybrid 是什么？

简单来说，这是一套社区蒸馏版视频生成 Checkpoint（未改动的原始权重镜像），底层基于 MiniMax H3 视频模型，通过 ComfyUI 工作流运行，一个混合（Hybrid）检查点同时支持三类任务：

项目文件一览（相对路径）：

💾 硬件配置：本地部署到底需要多大显存？

先看一个关键事实：根据 LICENSE 中的附注，MiniMax H3 的编码器使用了Qwen3-VL-32B这一约 320 亿参数的大视觉语言模型。也就是说，这是一个"重量级"视频生成模型，显存压力主要来自大编码器 + 视频 DiT 主干 + 长序列帧缓存三部分。

以下是针对本地部署的显存档位参考（个人显卡环境）：

💡 经验法则：视频生成模型对显存的消耗 ≈ 模型常驻占用 + 分辨率×帧数的激活缓存。分辨率和帧数每翻一倍，峰值显存都会显著上升，比单纯"模型太大"更容易触发 OOM。

内存与硬盘也别忽略

• 系统内存（RAM）：建议 ≥ 32GB，低显存模式下大编码器会被放到内存中，内存不足会直接卡死。
• 硬盘：SafeTensors 权重体积大，建议 SSD 存放，加快 ComfyUI 加载速度。
• 驱动：N 卡保持最新的 CUDA 兼容驱动即可。

⚡ 为什么 4 步 / 8 步蒸馏版能"救急"？

很多人以为"步数少 = 省显存"，其实蒸馏（distilled）主要省的是时间，不是峰值显存：

• 省时间：4 步版本只需 4 次采样迭代即可完成生成，8 步版本 8 次，而完整精度版本通常需要 20–25 步。GPU 空转等待的负担大幅下降，迭代实验速度提升数倍。
• 显存峰值：主要由模型尺寸、分辨率、帧数决定，蒸馏与不蒸馏差别不大。

所以正确的"分工"是：

1. 快速预览提示词效果→ 选 4 步版
2. 正式出片→ 选 8 步版
3. 显存不够→ 靠下文 5 个技巧，而不是指望"换更少的步数"

🔧 显存不够时的 5 个实战优化技巧

技巧 1：降分辨率、减帧数（最立竿见影）

视频模型的激活缓存与「分辨率 × 帧数」强相关。先以较低分辨率 + 较少帧数（例如 720p 以下、30 帧左右起步）跑通工作流，再逐步上调。这是解决 OOM 的第一优先级。

技巧 2：启用 ComfyUI 低显存启动参数

在 ComfyUI 的启动脚本或快捷方式中添加参数（按需选择）：

• --lowvram：显存紧张时启用，将部分计算切分为小块
• --normalvram：中等显存的折中档位
• --use-split-cross-attention：拆分交叉注意力计算，降低注意力矩阵的显存峰值
• --disable-smart-memory：关闭智能显存管理，改为主动卸载，牺牲速度换稳定性

📌 一般优先试--use-split-cross-attention+ 降分辨率；仍然 OOM 时再加--lowvram。

技巧 3：把大编码器卸载到系统内存

由于编码器是 Qwen3-VL-32B 级别的超大模型，显存不足时可以让推理框架在不用到它的时候把它换出到 CPU 内存（offload / 自动卸载机制，ComfyUI 的 smart memory 即会尝试）。前提是你有足够的系统内存（建议 ≥ 32GB）。

技巧 4：优先使用 4 步 turbo 版

4 步版本采样迭代少、GPU 占用时间短，在显存"贴边"的机器上更容易跑完整个任务而不触发峰值溢出，也更适合反复调参预览。

技巧 5：清理 GPU 占用、用对精度

• 关闭浏览器硬件加速、浏览器标签页中的视频页面、其他 AI 工具等一切 GPU 占用进程。
• 保持FP16 半精度推理（现代 GPU 的默认精度），不要盲目尝试更高精度。
• 若工作流中出现不必要的重复加载，可合并节点、减少同一会话内的多次加载。

📊 推荐运行参数：采样器与 Shift 怎么配？

以下参数来自项目 README.md 的官方推荐表，照着填即可：

📝 使用 BRP Canvas 时，两个蒸馏检查点的默认值为shift video9、shift audio4，直接沿用即可，无需额外调整。

新手建议路线：4 步版 +euler/simple+ shift video 9 + shift audio 4先跑通，出片速度最快，再按需上调 8 步版。

✅ 下载后如何校验文件完整性？

权重文件体积大，建议下载完成后用 SHA-256 校验（官方校验值见 README.md）：

# Linux / macOS sha256sum DasiwaMinimaxH3_dasiwaHybrid4turboV1.safetensors

Windows 用户可在 PowerShell 中执行：

Get-FileHash .\DasiwaMinimaxH3_dasiwaHybrid4turboV1.safetensors -Algorithm SHA256

将输出与上表比对一致，即可放心放入 ComfyUI 的模型目录使用。

❓ 常见问题（FAQ）

Q1：报错CUDA out of memory/ OOM 怎么办？按顺序尝试：降分辨率和帧数 → 加--use-split-cross-attention→ 加--lowvram→ 关闭其他 GPU 程序。仍失败说明硬件档位不足，建议升级显卡或使用云端 GPU。

Q2：生成速度太慢？确认用的是 4 步/8 步 turbo 版（而非 20–25 步的完整精度版），采样器选euler/simple，步数严格按推荐值设置。

Q3：生成的音视频节奏/质量不理想？调整shift video（6–12）与shift audio（3–5）参数，BRP Canvas 默认 9 / 4 是安全起点。

Q4：能只下载其中一个文件吗？可以。4 步版与 8 步版相互独立，按你的速度和画质偏好任选其一即可。

⚖️ 许可与合规提醒（重要）

本项目并非 MiniMax 或 DaSiWa 的官方发行版，使用前请务必阅读 LICENSE 中的《MiniMax H3 社区许可协议》，特别注意：

• 地域限制：欧盟、英国、韩国、美国不在默认授权范围内（Excluded Territories）。
• 商业条款：年营收超过 2000 万美元的商业产品需另行书面授权；商用界面需显著标注 "MiniMax H3"。
• 用途限制：须遵守协议附带的可接受使用政策（Exhibit A），不得用于违法、危害他人等用途。

总结：DaSiWa-MiniMax-H3-Hybrid 把 MiniMax H3 的完整能力压缩进了 4 步 / 8 步两个 turbo 检查点，让消费级显卡也能以最短的采样步数出片。显存不够时，记住这个优先级：降分辨率减帧数 → 开低显存参数 → 编码器卸载 → 换 4 步版 → 清掉其他 GPU 占用。配置对了参数（euler/simple+ shift video 9 + shift audio 4），你的本地视频生成工作流就稳稳跑起来了。