MiniMax H3 Turbo LoRA
ComfyUI 指南
这是一份经过来源核验的社区 Turbo LoRA 预览指南：说明它改变什么、如何安装、哪些工作流已有文档，以及如何测试而不把预览表现夸大成普遍结论。
请将其视为社区预览，而不是官方发布。
作者的 Hugging Face 模型卡与 ComfyUI 节点仓库提供了实际权重、安装路径和示例工作流，同时将当前检查点标为存在已知伪影的预览代码。
预览状态
当前 ckpt850 预览被记录为低步数下较锐利，但作者报告了塑料感皮肤以及过锐颗粒或噪声。检查点更新后应重新测试。
不是 MiniMax 官方发布
LoRA 与自定义节点属于社区作品。H3 基础模型的许可证和 LoRA 仓库的许可证需要分别核对。
可复现路径
该仓库提供 ComfyUI-Manager 路径、git clone 命令、LoRA 文件夹和 T2V 示例工作流。
该适配器面向低步数 H3 生成。
请以作者提供的工作流为参考。下面描述的是预览版本已有文档记录的表现，不保证适用于每个提示词、GPU、基础模型变体或未来检查点。
| 领域 | 文档记录的表现 | 实际解读 |
|---|---|---|
| 采样 | 当前作者工作流使用带 4 步 schedule 的 Turbo Sampler。 | 请保持匹配的 sampler 与 scheduler 配套使用；不要只把 LoRA 复制到无关的 4 步图中。 |
| 音频路径 | 作者文档说明 H3 视频和音频使用不同的 flow schedule。 | 低步数下，请使用节点仓库提供的 Turbo Sampler，以便单独处理音频路径。 |
| 质量取舍 | 当前预览被描述为较锐利，但存在已知的塑料感皮肤和过锐颗粒或噪声。 | 请将伪影与提示词、seed 一起记录，不要声称预览版本能改善所有场景。 |
| 权重类型 | 模型卡列出了标准低秩更新权重，包括当前 EMA ckpt850 文件和较早检查点。 | 请选择一个确切文件并记录文件名，不要比较未注明名称的检查点。 |
让适配器与基础模型和工作流匹配。
下面的兼容性说明均来自作者当前文档。ComfyUI 节点与检查点仍在快速变化，每次新配置前都应重新核对来源。
| 项目 | 作者文档中的状态 | 不要想当然 |
|---|---|---|
| 完整 BF16 基础模型 | 列为兼容的 MiniMax H3 基础模型。 | BF16 结果会预测量化基础模型上的相同伪影表现。 |
| INT8 ConvRot 基础模型 | 列为兼容的完整基础模型变体。 | 仅凭 INT8 文件名就能确定正确工作流。 |
| 剪枝 INT8 或 FP8 基础模型 | 节点文档说明它可以检测剪枝基础模型。 | 较旧节点版本支持所有当前剪枝变体。 |
| T2V | 文档明确说明，并提供现成示例工作流。 | 无关采样器可以在 4 步下替代 Turbo Sampler。 |
| I2V | H3 工作流路径明确记录为支持。 | 参考图表现会与所有 T2V 提示词完全相同。 |
| R2V | 作者当前指南没有明确记录。 | 不要将 R2V 支持发布为已确认；如果尝试，请单独测试。 |
关于基础模型、文本编码器和 VAE 文件布局，请参考 模型文件与下载指南 以及当前官方 H3 工作流。
安装节点、LoRA 和匹配的工作流。
1 / 安装自定义节点
在 ComfyUI-Manager 中搜索 MiniMax-H3 Turbo，或手动安装作者仓库。
2 / 放置 LoRA
从作者模型卡下载一个 safetensors 文件，并放入 ComfyUI LoRA 文件夹。
3 / 准备基础文件
Turbo LoRA 不会替代 H3 扩散模型、文本编码器以及视频和音频 VAE。
cd ComfyUI/custom_nodes git clone https://github.com/larryvrh/ComfyUI-MiniMax-H3-Turbo
LoRA 文件夹
ComfyUI/models/loras/
当前预览文件
minimax_h3_turbo_4step_ema_ckpt850.safetensors
大致大小
模型卡列出的 BF16 权重大约为 744 MB。下载前请查看实时文件条目。
安装后重启 ComfyUI，并从作者示例工作流或当前官方 H3 T2V/I2V 工作流开始。不要假设旧节点图兼容最新检查点。
调整采样器路径，而不是重做整个工作流。
作者记录的配置保留 H3 conditioning、VAE 解码和音频输出路径，然后在模型到采样器的边界插入 Turbo LoRA 与 Turbo Sampler。
Load Diffusion Model → MiniMax-H3 Turbo LoRA → MiniMax-H3 Turbo Sampler → SamplerCustomAdvanced
| 控制项 | 作者工作流的起点 | 测试备注 |
|---|---|---|
| 采样器节点 | MiniMax-H3 Turbo Sampler | 使用作者仓库提供的节点。 |
| 调度器 | simple | 将其与提供的低步数配置配套使用。 |
| 步数 | 当前 ckpt850 预览使用 4 步 | 更换检查点或节点版本后请重新测试。 |
| LoRA 强度 | 从作者默认值 1.0 开始 | 请先建立基线再调整；强度会改变锐度与伪影之间的取舍。 |
T2V
以作者示例工作流作为接线参考。
I2V
使用相同的文档化 Turbo 路径，并接入官方 H3 图生视频输入。
R2V
作者指南没有确认 R2V。任何结果都应视为实验，而不是受支持的配方。
比较时要保持条件一致。
低步数预览可能有用，但不代表普遍更快或更好。下结论前请先让比较可复现。
- 固定基础模型、文本编码器、VAE、提示词、seed、分辨率、帧数和输出格式。
- 使用原生 H3 工作流运行基线，并记录实际耗时、步数、GPU 以及音视频问题。
- 使用确切的检查点文件名和作者采样器路径运行 Turbo 工作流。
- 记录 LoRA 强度、scheduler、步数、节点版本以及是否启用了 low_vram。
- 分别检查运动、面部、纹理、音频同步、音频失真和重复帧伪影。
- 请将结果标记为预览数据；不要把一个提示词或一块 GPU 的结果当成通用基准。
先修复节点图，再修改提示词。
| 症状 | 可能原因 | 首先检查 |
|---|---|---|
| 4 步时音频失真 | 普通采样器让音频和视频使用同一个 schedule。 | 使用作者的 MiniMax-H3 Turbo Sampler 和匹配工作流。 |
| 导入后节点缺失 | 自定义节点未安装、版本过旧或重启后没有加载。 | 更新或重新安装作者节点，重启 ComfyUI，然后重新打开示例工作流。 |
| 输出模糊或拖影 | LoRA 强度、检查点或采样器设置与测试不匹配。 | 从作者默认值和当前确切检查点开始，然后一次只改变一个变量。 |
| 过锐颗粒或塑料感皮肤 | 已知预览伪影或 LoRA 强度过高。 | 降低强度，记录检查点，并与基础工作流比较。 |
| 显存不足 | 基础模型、分辨率、帧数或运行模式超出可用显存。 | 尝试 low_vram 或降低分辨率/帧数，然后记录改动。 |
| R2V 表现不符合预期 | 作者指南没有记录 R2V 兼容性。 | 在将问题归咎于 LoRA 之前，请先回到文档记录的 T2V/I2V 路径。 |
常见问题
MiniMax H3 Turbo LoRA 是 MiniMax 官方发布的吗？
不是。作者的模型卡将其标为社区预览。它不是 MiniMax 官方发布，当前预览也存在已知伪影。
安装 MiniMax H3 Turbo LoRA 需要什么？
安装作者的 ComfyUI 自定义节点，将 LoRA safetensors 文件放入 ComfyUI/models/loras/，准备好官方 H3 基础文件，并从匹配的 Turbo 工作流开始。
Turbo LoRA 可以用于 R2V 吗？
作者文档明确说明了 T2V 和 I2V，但没有记录 R2V 兼容性，因此应将 R2V 视为未经核验，并单独测试。
使用 4 步时为什么音频会失真？
作者文档说明 H3 视频与音频使用不同的 flow schedule。低步数设置下，应使用示例工作流中的 Turbo Sampler，而不是普通采样器。
请同时参考作者发布内容与官方基础模型来源。
最后核验：2026 年 8 月 7 日。Turbo LoRA 属于社区预览，下载或报告兼容性前请查看实时模型卡和节点仓库。