10分钟上手Minimax-H3-ComfyUI：ComfyUI视频画质增强从零到首条成片完全教程

【免费下载链接】Minimax-H3-ComfyUI项目地址: https://ai.gitcode.com/hf_mirrors/Alissonerdx/Minimax-H3-ComfyUI

Minimax-H3-ComfyUI是一套专为 ComfyUI 打造的视频画质增强 LoRA 工具箱，基于 MiniMax H3 视频模型构建。它只需一次"二次生成"，就能在保持照片级真实感的前提下，让模糊、细节不足的视频画面变得更锐利清晰。项目内附两条开箱即用的 ComfyUI 工作流，新手也能在 10 分钟内跑出自己的第一条增强成片。

项目里有什么？3 个模块一文看懂

整个仓库非常精简，所有资产分装在三个目录中，各管一摊：

两大 LoRA 定位不同：

• 🔍minimax_h3_lms_v1.0_r64（画质增强）：Rank-64 权重，官方称之为 "a little more sharpness"（多一分锐利）。它通过"对齐引导潜变量"（aligned guide latents）让源视频逐帧、逐像素地约束生成过程，专治画面发虚、细节涂抹。
• 🎨minimax_h3_style_transfer_v1.0_r64（风格迁移）：配合参考图工作流使用，为视频注入新的视觉风格。

项目说明文档见 README.md。

开始之前：准备 ComfyUI 环境与基础模型

运行本项目需要以下准备，缺一不可：

1. 已安装 ComfyUI，且能正常启动界面；
2. MiniMax H3 基础模型权重：官方 ComfyUI 适配版权重（ref2va版本为主力基座，fl2va理论上可用但测试较少）；
3. 工作流依赖的自定义节点：工作流中用到了GetNode/SetNode（KJNodes）、VHS_LoadVideoFFmpeg（VideoHelperSuite）、AIToolkitMiniMaxH3RefVideo（AIToolkit-MiniMaxH3）等节点，请先在 ComfyUI 管理器中安装对应插件，否则导入工作流时会出现红框报错；
4. 一块显存足够的显卡：视频扩散生成对显存要求不低，工作流内置了MiniMaxLowVRAMAttention等节点帮助低显存运行，但建议 12GB 起步。

第一步：克隆 Minimax-H3-ComfyUI 仓库

在 ComfyUI 的custom_nodes同级目录或任意位置执行：

git clone https://gitcode.com/hf_mirrors/Alissonerdx/Minimax-H3-ComfyUI

克隆完成后，将 LoRA 文件放入 ComfyUI 的模型目录：

• 画质增强 LoRA：loras/minimax_h3_lms_v1.0_r64.safetensors
• 风格迁移 LoRA：loras/minimax_h3_style_transfer_v1.0_r64.safetensors

第二步：导入官方工作流，5 分钟搭好画质增强流水线

无需手动连节点——直接双击打开 ComfyUI，把仓库里的工作流 JSON 拖入界面即可：

• 画质增强工作流：workflows/minimax_h3_lms_workflow.json
• 风格迁移工作流：workflows/minimax_h3_style_transfer_workflow.json

以画质增强工作流为例，它已经帮你接好了完整链路：加载源视频 → 分辨率对齐 → 挂载 guide 引导（MiniMaxH3AddGuide）→ 采样生成 → 输出增强成片。你只需要关注 4 个地方：

官方推荐的触发提示词（英文）：

Enhance this video with sharp, crisp details while preserving a natural photorealistic appearance.

第三步：跑通首条成片前，必须记住的 3 条规则

这条 LoRA 的效果高度依赖"引导对齐"机制，踩坑基本都出在下面三点上：

1. guide 锚定第 0 帧：源视频从frame_idx = 0开始作为引导输入，对应工作流中的MiniMaxH3AddGuide节点（ComfyUI 对 MiniMax H3 的原生支持，无需额外安装）。
2. 引导与目标同分辨率、同时长：guide 必须在目标分辨率下编码，且源视频与目标视频的帧数都要落在合法档位上——17k+5 帧（如 5、22、39、56、73、90、107、124……）。帧数或分辨率不匹配，对齐直接失效。
3. 它更适合作"第二遍处理"：该 LoRA 的设计初衷是锐化已生成的片段，而非从零生成。用它增强你已有的视频，效果最稳。

另外，工作流里的MiniMaxH3ReferenceToVideo节点（参考视频）属于可选实验项：叠加 guide 与 reference 两种条件输入并非必然更好，新手建议先保持默认跑通，再自行探索。

效果如何？看看官方对比视频

仓库examples/目录提供了 13 段前后对比视频，左模糊、右锐利，差距一目了然。建议优先观看带-audio的版本（如 examples/comparison-2-audio.mp4、examples/comparison-3-audio.mp4），确认音频在增强后依然完整保留；其余如 examples/comparison-1.mp4 到 examples/comparison-8.mp4 覆盖不同画面类型，可作为你判断"自己的视频适不适合增强"的参考。

进阶玩法：用风格迁移 LoRA 给视频换风格

跑通画质增强后，可以试试风格迁移路线：导入 workflows/minimax_h3_style_transfer_workflow.json，加载一张参考图（LoadImage节点）定义目标风格，再喂入源视频，即可生成风格化视频。工作流内置了TextGenerate节点自动组织提示词，进一步降低了上手门槛。

常见问题速查（新手最容易卡的 3 个点）

• 导入工作流一堆红框？→ 缺自定义节点，回到"准备环境"一节补齐后刷新页面。
• 生成结果和源视频对不上、画面漂移？→ 九成是 guide 分辨率或帧数没对齐，检查 17k+5 档位。
• 想要更稳的锐化效果？→ 用"已生成成片再增强一次"的两段式流程，而不是直接文生视频。

写在最后

Minimax-H3-ComfyUI 用不到 4 个文件（2 个 LoRA + 2 个工作流）就搭起了一条完整的 ComfyUI 视频画质增强流水线，Apache 2.0 开源协议也让商用没有负担。按照"克隆仓库 → 导入工作流 → 改 4 个节点 → 按规则对齐 guide"的四步走法，你现在就可以开始增强自己的第一条视频了。

【免费下载链接】Minimax-H3-ComfyUI项目地址: https://ai.gitcode.com/hf_mirrors/Alissonerdx/Minimax-H3-ComfyUI