ComfyUI也能生成3D模型?hunyuan3D_2.1_repackaged完整概览:快速看懂腾讯Hunyuan3D 2.1

原创2026-10-17 17:58:381,926 阅读

ComfyUI也能生成3D模型?hunyuan3D_2.1_repackaged完整概览:快速看懂腾讯Hunyuan3D 2.1

本文为 ComfyUI 重新打包的 hunyuan3D_2.1_repackaged 模型包完整概览,它就是腾讯 Hunyuan3D 2.1 的 3D 模型文件,让 ComfyUI 从图片或文字直接生成 3D 模型,属于"下载即放、放完即用"的单文件模型包。

一、hunyuan3D_2.1_repackaged 是什么?

Hunyuan3D 2.1 是腾讯混元团队推出的端到端 3D 资产生成模型,支持文生 3D、图生 3D,可直接产出带几何形状和纹理的 3D 模型,在开源 3D 生成领域热度很高。

而 hunyuan3D_2.1_repackaged 就是面向 ComfyUI 生态的"重新打包版"(Repackaged):

  • 📦 单文件交付:整个核心模型打包成一个 hunyuan_3d_v2.1.safetensors(模型标签为 diffusion-single-file),下载一个文件就能开工,不用在原始仓库里挑三拣四;
  • 🔌 ComfyUI 原生适配:文件直接放入 models/diffusion_models/ 目录,配合 ComfyUI 的 3D 工作流即可运行;
  • ⚖️ 社区许可:采用 Tencent Hunyuan Community License,使用前建议留意条款。

简单说:原始仓库面向代码推理,本仓库面向 ComfyUI 节点化使用。

二、仓库结构速览:2 个文件 + 7.4GB 模型

整个仓库非常精简,只有两个文件:

文件 说明 大小
hunyuan_3d_v2.1.safetensors Hunyuan3D 2.1 核心 3D 扩散模型,ComfyUI 加载的就是它 约 7.4 GB
README.md 官方使用说明(模型放置路径 + 工作流入口) -

⚠️ 新手注意:hunyuan_3d_v2.1.safetensors 由 Git LFS 管理。如果你直接 clone 仓库后发现文件只有几百字节,那不是文件坏了,而只是一个 LFS 指针(指针里记录的 size 7365943290 才是真实大小,约 7.4GB)。解决办法见下文 FAQ。

三、安装教程:3 步把 Hunyuan3D 2.1 模型放入 ComfyUI

第 1 步:获取模型文件

git clone https://gitcode.com/hf_mirrors/Comfy-Org/hunyuan3D_2.1_repackaged

如果本地文件仍是 LFS 指针,执行 git lfs install && git lfs pull 拉取真实文件(约 7.4GB,请预留磁盘空间)。

第 2 步:放入 ComfyUI 指定目录

按 README.md 的要求,把模型文件移动到:

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── hunyuan_3d_v2.1.safetensors

第 3 步:重启 ComfyUI,搜索 3D 工作流

重启后,在 ComfyUI 内置模板库中找到官方 3D 模板 "HY 3D 2.1"(模板文件 3d_hunyuan3d-v2.1.json,README 中已给出入口),双击打开即可开始跑图生 3D。

✅ 三步走完,ComfyUI 3D 模型生成环境就配好了。

四、ComfyUI 生成 3D 模型:工作流怎么用?

ComfyUI 里使用 Hunyuan3D 2.1 的典型链路是:

  1. 输入:加载一张图片(图生 3D)或输入文字描述(文生 3D);
  2. 形状生成:由 hunyuan_3d_v2.1.safetensors 驱动,输出 3D 形状(shape);
  3. 纹理与网格:对形状做纹理细化,最终导出 mesh/GLB 等 3D 模型格式。

几点实操建议:

  • 🧩 需要在 ComfyUI 管理器中安装支持 Hunyuan3D 的社区 3D 自定义节点包(如 ComfyUI-Hunyuan3D-Wrapper),模型文件放到 diffusion_models 后才能被节点识别;
  • 🖥️ 显存参考:形状生成阶段 8GB 显存起步可跑,完整"形状 + 纹理"管线建议 12GB+,显存紧张时可降低采样步数或分辨率;
  • ⏱️ 3D 生成耗时明显长于 2D 出图,首跑耐心等,属于正常现象。

五、Hunyuan3D 2.1 常见问题 FAQ

Q1:clone 下来的文件只有 135 字节,是不是下载失败了?

不是。该文件走 Git LFS 通道,仓库里存的只是指针。安装 git-lfs 后执行 git lfs pull 即可拿到约 7.4GB 的完整模型。

Q2:和腾讯官方 tencent/Hunyuan3D-2.1 仓库有什么区别?

官方仓库是"代码 + 模型"全家桶,适合开发者写代码推理;本仓库(hunyuan3D_2.1_repackaged)是单文件重打包,专为 ComfyUI 节点化工作流设计,普通用户拿来即用,无需关心推理代码。

Q3:必须放 diffusion_models 目录吗?

是的。README 明确规定放入 ComfyUI/models/diffusion_models/,放错目录节点会找不到模型、工作流直接报错。

六、总结

hunyuan3D_2.1_repackaged 的价值就一句话:把腾讯 Hunyuan3D 2.1 的 3D 生成能力,压缩成一个放进 ComfyUI 就能用的模型文件。7.4GB 的下载量换来的是图生 3D、文生 3D 的完整管线,对想尝鲜 3D 生成、又不想折腾代码环境的新手来说,目前是最平滑的入口之一。

📌 建议阅读顺序:先看 README.md 确认模型路径 → 按上文三步安装 → 打开 "HY 3D 2.1" 模板出第一个 3D 模型。

登录后查看全文
hunyuan3D_2.1_repackaged