---
title: minimax-h3-comfyui
canonical_url: "https://www.modelscope.cn/models/infodog/minimax-h3-comfyui"
md_url: "https://www.modelscope.cn/models/infodog/minimax-h3-comfyui.md"
repository: infodog/minimax-h3-comfyui
chinese_name: minimax-h3-comfyui
last_updated: 2026-11-12
license: "Apache License 2.0"
pipeline_tag: text-to-video-synthesis
tasks:
  - text-to-video-synthesis
parameters: 278.9B
tensor_type:
  - F16
  - I8
  - I64
  - F8_E4M3
  - BF16
  - F32
  - U8
library_name:
  - safetensors
downloads: 1851
stars: 8
tags:
  - comfyui
  - minimax-h3
  - video-generation
---

# minimax-h3-comfyui

> minimax-h3-comfyui - infodog 在 ModelScope 开源的模型。用于comfyui的模型文件

infodog/minimax-h3-comfyui 是 ModelScope 魔搭社区上的 278.9B 参数text-to-video-synthesis模型，采用 Apache License 2.0 许可。

- **Repository**: infodog/minimax-h3-comfyui
- **License**: Apache License 2.0
- **Tasks**: text-to-video-synthesis
- **Parameters**: 278.9B
- **Tags**: comfyui, minimax-h3, video-generation
- **Downloads**: 1851
- **Stars**: 8
- **Last updated**: 2026-11-12

Source: https://www.modelscope.cn/models/infodog/minimax-h3-comfyui

---

# minimax-h3-comfyui

CollectiveMind 桌面端本地推理节点的**运行时与模型权重分发仓库**。

## 仓库内容

### 1. ComfyUI 官方便携版运行时（`comfyui_portable/`）

来自 [Comfy-Org/ComfyUI](https://github.com/Comfy-Org/ComfyUI/releases) 的 Windows 便携版，
内置 python_embeded（含 CUDA 版 PyTorch），解压即用，用于本地推理节点的运行环境。
部分版本目录同时提供源码包（`.tar.gz`），适合 Linux 或自定义环境。

按版本分目录存放，可用 `comfyui_portable/versions.txt` 查询当前可下载的版本：

| 版本目录 | ComfyUI 版本 | 说明 |
|---|---|---|
| `comfyui_portable/0.43.0/` | v0.43.0 / v0.43.2 | 当前推荐；含 v0.43.2 源码包 |
| `comfyui_portable/0.34/` | v0.34.0 | 旧版（2026-08-26 发布），含 intel 与 cu126 变体 |

**版本清单（机器可读）**：`comfyui_portable/versions.txt`

软件更新检查时拉取该文件即可获知有哪些版本、对应哪个显卡变体、文件大小与 SHA-256：

```
https://modelscope.cn/models/infodog/minimax-h3-comfyui/resolve/master/comfyui_portable/versions.txt
```

格式为每行一条 `|` 分隔记录：

```
version | dir | file | type | size_bytes | sha256 | python | accel | gpu | released | stable
```

其中 `type` 为 `portable`（Windows 便携版，含内置 Python，解压即用）或 `source`（源码包，需自行安装依赖）。

各版本内的文件与适用硬件：

| 文件 | 适用硬件 | 内置环境 |
|---|---|---|
| `ComfyUI_windows_portable_nvidia.7z` | NVIDIA RTX 20 系及更新 | CUDA 13.0 / Python 3.13 |
| `ComfyUI_windows_portable_nvidia_cu126.7z` | NVIDIA GTX 10 系及更早 | CUDA 12.6 / Python 3.12 |
| `ComfyUI_windows_portable_amd.7z` | AMD 显卡（ROCm） | ROCm 7.2 / Python 3.12 |
| `ComfyUI_windows_portable_intel.7z` | Intel Arc 独显（XPU） | Intel XPU / Python 3.13 |

> `nvidia_cu126` 变体仅面向 10 系及更老显卡，**不可用于 20 系及以上**。

### 2. MiniMax H3 ComfyUI 量化权重

MiniMax H3 视频生成模型的 **ComfyUI 专用转换/量化版**（int8/nvfp4 量化，
显存需求大幅低于官方 bf16 分片版）：

| 文件 | 大小 | 用途 |
|---|---|---|
| `diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors` | 19.53 GB | 图生视频（首帧图 → 视频） |
| `diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors` | 19.53 GB | 参考生视频（参考图/视频 → 视频） |
| `text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors` | 14.61 GB | 文本编码器（Qwen3-VL 32B nvfp4 量化） |
| `vae/minimax_h3_video_vae_fp16.safetensors` | 4.85 GB | 视频 VAE |
| `vae/minimax_h3_audio_vae_fp32.safetensors` | 0.56 GB | 音频 VAE |

合计约 59.1 GB。

### 3. LoRA（`loras/`）

放入 `ComfyUI/models/loras/` 即可加载。**清单文件（机器可读）**：`loras.txt`

```
https://modelscope.cn/models/infodog/minimax-h3-comfyui/resolve/master/loras.txt
```

格式为每行一条 `|` 分隔记录：

```
file | size_bytes | sha256 | base_model | type | steps | strength | trigger | source | desc
```

| LoRA | 适配底模 | 类型 | 步数 | 触发词 |
|---|---|---|---|---|
| `wushu_action_v7_fl2va_aitoolkit_adaln_full-int8convrot_bf16te_2000step.safetensors` | MiniMax H3 fl2va | 风格 | — | `wushu_action` |
| `minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors` | MiniMax H3 fl2va | 加速 | 8 | — |
| `minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors` | MiniMax H3 ref2va | 加速 | 4 | — |
| `Flux_2-Turbo-LoRA_comfyui.safetensors` | FLUX.2 | 加速 | 8 | — |
| `Qwen-Image-2512-Lightning-4steps-V1.0-fp32.safetensors` | Qwen-Image 2512 | 加速 | 4 | — |
| `Qwen-Image-Edit-2511-Lightning-4steps-V1.0-bf16.safetensors` | Qwen-Image-Edit 2511 | 加速 | 4 | — |

**武术打斗 LoRA**（`wushu_action_v7_...`）为动作风格 LoRA，触发词 `wushu_action` 必须放在提示词最前面，
推荐权重 0.6–1.0。已实测确认其 50 个 Transformer block 的 4 类模块（`attn.qkv_proj` / `attn.out_proj` /
`mlp.fc1` / `mlp.fc2`）与本仓库的 `minimax_h3_fl2va_pruned_int8_convrot` 底模完全匹配，可直接加载，无需键名重映射。

### 4. PDD Acc 蒸馏加速权重（`pdd_acc/`）

MiniMax H3 的 **PDD Acc（Progressive Distillation Distillation-Acceleration）** 蒸馏权重，
配合自定义节点 `ComfyUI-MiniMax-H3-PDD-Acc`（`MiniMaxH3PDDAccApply`）使用：把底模的
adaln/trunk 打上蒸馏补丁，采样步数压到 8 步（euler + 节点输出的分块 sigmas，CFG 1.0）。

| 文件 | 大小 | 用途 |
|---|---|---|
| `pdd_acc/MiniMax-H3-Ref2VA-Acc-8Step.safetensors` | 1.28 GB | 参考生视频（Ref2VA）：配 `diffusion_models/minimax_h3_ref2va_pruned_int8_convrot` |
| `pdd_acc/MiniMax-H3-FL2VA-Acc-8Step.safetensors` | 1.28 GB | 文生/图生视频（FL2VA）：配 `diffusion_models/minimax_h3_fl2va_pruned_int8_convrot` |

放入 `ComfyUI/models/pdd_acc/` 即可（节点自带该目录注册；不属于 `loras/`）。

> 两个文件结构相同（键集一致），必须与底模配对使用：FL2VA 权重配 ref2va 底模也能加载，
> 但会渲染出静默错的内容——节点的 `partition_check` 会按 `final_layer.video_out`
> 指纹做配对校验（默认 `error`）。

### 5. 自定义节点（`custom_nodes/`）

**只发 .7z 归档**：`custom_nodes/<包名>.7z`（归档根目录 = 包名目录，解压到
`ComfyUI/custom_nodes/` 即可）。桌面端 / 远端下载后先校验 `sha256` 再解压，
一个文件一次成型，**不受 Git 换行规范化影响**。

> 不再提供 `custom_nodes/<包名>/…` 逐文件镜像（2026-11-04 移除）：镜像里 `.py/.md/LICENSE`
> 的字节数会被 Git 换行规范化（CRLF↔LF）改掉，导致「大小校验永远不过」，正是引入 7z 的原因。
> 节点主机上没有 7z 时请先装 p7zip（`apt install p7zip-full`），或用桌面端安装。

| 节点包 | 用途 | 上游 |
|---|---|---|
| `custom_nodes/ComfyUI-MiniMax-H3-PDD-Acc.7z` | MiniMax H3 PDD Acc 蒸馏加速（`MiniMaxH3PDDAccApply`），模型组 `minimax-video-r2v-pdd` 依赖 | [Jalen-Brunson/ComfyUI-MiniMax-H3-PDD-Acc](https://github.com/Jalen-Brunson/ComfyUI-MiniMax-H3-PDD-Acc) @ `311a65d` |

- 归档：`size=2193425`，`sha256=b63fba25fa183cc39b3355b6e20da4a260ef09882d384a50e96857ba3916aa82`
- 归档内只含运行期需要的 15 个文件（`nodes.py` / `pdd_acc_core.py` / `adaln_basis/` /
  `partition_fingerprints/` / LICENSE / README + bake 脚本）；`tests/`、`.idea/`、
  `example_workflows/` 不入包。

## 下载方式

### HTTP 直链（支持断点续传）

```
https://modelscope.cn/models/infodog/minimax-h3-comfyui/resolve/master/<文件路径>
```

例如：
```
https://modelscope.cn/models/infodog/minimax-h3-comfyui/resolve/master/comfyui_portable/0.43.0/ComfyUI_windows_portable_nvidia.7z
https://modelscope.cn/models/infodog/minimax-h3-comfyui/resolve/master/comfyui_portable/versions.txt
https://modelscope.cn/models/infodog/minimax-h3-comfyui/resolve/master/loras.txt
https://modelscope.cn/models/infodog/minimax-h3-comfyui/resolve/master/diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors
```

### SDK 整仓下载

```bash
pip install modelscope
```

```python
from modelscope import snapshot_download
model_dir = snapshot_download('infodog/minimax-h3-comfyui')
```

### Git 克隆

```
git clone https://www.modelscope.cn/infodog/minimax-h3-comfyui.git
```

## 说明

- 模型权重基于 MiniMax H3 官方开源版本（[MiniMax/MiniMax-H3](https://modelscope.cn/models/MiniMax/MiniMax-H3)）转换量化，仅供 ComfyUI 工作流使用
- ComfyUI 便携版为官方原始发行包，未做修改
- 其他公开权重（Z-Image、FLUX.2、Qwen-Image-Edit、SD3.5 等）请直接从官方/Comfy-Org 仓库获取
