在 ComfyUI 里跑 Hunyuan3D 2.x：两个阶段、封装节点包的选择与首次运行的报错排查
Hunyuan3D 2.x 由负责几何的扩散模型和独立的贴图阶段组成，ComfyUI 可以把两者串成一张节点图。下面讲清图的接法、每条路线要花多少显存，以及常见报错到底在说什么。
ComfyUI 最初并不是为 3D 准备的工具，它是一步步长成现在这样的：先是社区节点包把各路研究仓库包了进来，随后官方把 Hunyuan3D 2.0 的核心节点做进主程序，再往后又加上了内置的 3D 预览和 GLB 导出节点。今天同一张节点图就能把生成的图像交给形状模型，写出一个网格文件，全程不用离开浏览器标签页。
节点图并没有替你处理底下的杂事。一套能用的环境意味着：挑一个自己显卡扛得住的模型家族，把几十 GB 的权重下载到各加载器要求的目录，并且接受输出是一团密集三角面，而不是成品资产。
ComfyUI 给 3D 流程加了什么，又留下了什么
ComfyUI 本质上是带队列、模型缓存和浏览器界面的节点图执行器，它在 3D 上的支持远不如图像那么完整。你能得到的是可复现的执行：把图像、形状模型、解码器和导出节点串成一张工作流，存成 JSON。你得不到的是拓扑、UV 质量、绑定和打印前的处理。
第一次出图之前：节点、权重和目录
- 版本足够新的 ComfyUI，至少要带这些 3D 核心节点：EmptyLatentHunyuan3Dv2、Hunyuan3Dv2Conditioning、VAEDecodeHunyuan3D、VoxelToMeshBasic、Preview3D 和 SaveGLB。2024 年的整合包没有这些节点，第三方节点包也补不回来。
- ComfyUI Manager。目前多数 3D 玩法仍依赖社区节点包：Kijai 的 Hunyuan3D 封装包（Hy3DModelLoader、Hy3DGenerateMesh、Hy3DVAEDecode）、3D-Pack 系列，以及各种 TRELLIS 封装包。
- 放在加载器指定目录里的权重。封装包的 Hy3DModelLoader 从 models/diffusion_models 读取 hunyuan3d-dit-v2-0.safetensors，TRELLIS 系列通常要求自己的子目录。磁盘上要留 15–40 GB，上色阶段还需要 CUDA 扩展，Windows 上的安装失败大多出在这里。
- 上游的图像模型。ComfyUI 里能用的 3D 模型几乎都以图像为条件，文字提示词必须先生成图片。
目前在 ComfyUI 里能跑起来的模型家族
| 模型家族 | 输入 | 典型显存占用 | 输出结果 |
|---|---|---|---|
| Hunyuan3D 2.0 / 2.1 全精度 | 单图，或多达 4 个视图 | 16 GB，PBR 贴图阶段要 24 GB | 带贴图的网格，轮廓不错，三角面密集 |
| Hunyuan3D mini 与 turbo | 单图 | 8–12 GB，需要配合卸载 | 步数更少，细节更软 |
| TRELLIS 与 TRELLIS 2 | 1–4 张图 | 16 GB 起步 | 稀疏潜表示的网格，上色后带 UV |
| Stable Fast 3D | 单图 | 大约 6–8 GB | 已展开 UV 的网格，自带烘焙贴图 |
| TripoSR | 单图 | 大约 6 GB | 生成很快的无贴图网格，只有顶点色 |
选哪个主要是显存问题。如果目标是能打印的轮廓，Hunyuan3D 的资料最全，mini 和 turbo 权重能把门槛压在 12 GB 以内。想要自带 UV 和 PBR 贴图、又不想单独烘焙，TRELLIS 和 Stable Fast 3D 能直接给出，代价是显存，或者几何更生硬。TripoSR 是小显存显卡的兜底：每次只要几秒，只有顶点色。
Hunyuan3D 2.x：文档最完整的实心形状路线
在 Kijai 的封装包里，节点图可以很短。Hy3DModelLoader 加载 DiT 权重，输出 pipeline 和 VAE；Hy3DGenerateMesh 采样潜变量；Hy3DVAEDecode 按你选的八叉树分辨率把它解码成网格。turbo 权重通常 5–8 步，完整模型约 50 步。官方核心流程用 EmptyLatentHunyuan3Dv2、Hunyuan3Dv2Conditioning 和 VAEDecodeHunyuan3D 走到同一步，再接 VoxelToMeshBasic，由密度阈值决定表面落点。贴图是独立的、也是更重的阶段。
TRELLIS 2 与更轻的替代方案：另一组取舍
TRELLIS 预测的是结构化的 3D 潜表示，而不是体素网格，它的 ComfyUI 节点包支持 1 到 4 张条件图，多视图路线因此更短。代价在显存和安装上：这类节点包跟着研究仓库快速变动，spconv 一类的编译轮子必须和 torch 版本匹配，舒服的运行起点大约 16 GB。Stable Fast 3D 反过来取舍：一次前向就出结果，占用约 6–8 GB，贴图已经烘焙到 UV 上。
图生 3D 的节点图，一步一步走
- 载入源图并裁成接近正方形，画面里只放一个主体，占画幅 60–80%。
- 用 CLIP Vision 编码，再送进 Hunyuan3Dv2Conditioning（单视图）或 Hunyuan3Dv2ConditioningMultiView（前、左、后、右四视图）。
- 建立空潜变量并采样：turbo 权重 5–8 步几秒结束，50 步的完整模型要几分钟。
- 解码成网格，八叉树分辨率是关键：256 是常规起点，384–512 会增加细节，代价按比例上升。
- 用 Preview3D 旋转查看相机没拍过的那些面，能立刻发现背面融化和肢体粘连，然后用 SaveGLB 导出。
真正影响成品的只有两个参数。八叉树分辨率决定体素阶段能留下多少表面细节；VoxelToMeshBasic 的密度阈值决定表面位置，取值偏低会让模型发胖，偏高则可能把细长结构断开。采样参数救不了一张主体重叠的照片。
显存分档：每张卡实际上能跑完什么
| 显卡显存 | 不加技巧就能跑 | 要放弃的东西 |
|---|---|---|
| 8 GB | TripoSR、Stable Fast 3D、Hunyuan3D mini 纯形状流程 | 量化或卸载运行、每个网格几分钟、没有上色阶段 |
| 12 GB | Hunyuan3D turbo 几何，以及用卸载跑的小规模 TRELLIS | 采样更久、八叉树分辨率更低、偶尔卡顿 |
| 16 GB | 完整的 Hunyuan3D 2.0 形状模型、TRELLIS 图生 3D | PBR 贴图阶段，它仍要抢同一块显存 |
| 24 GB | Hunyuan3D 2.1 加上色模型、TRELLIS 2、批量对比 | 结构上不再受限，瓶颈变成墙上时钟 |
ComfyUI 的缓存行为和第几档显存一样重要，它会把模型留在显存里跨任务复用，队列空了也未必释放。用 --lowvram、--novram 或 --disable-smart-memory 启动会改变常驻内容；社区量化的 DiT 权重用一点表面质量换整整一档显存。卸载到系统内存是真能跑通的：任务会完成，只是时间花在 PCIe 上搬运张量。
文生 3D 和草图转 3D 都在同一张图里
ComfyUI 里封装的 3D 模型都以图像为条件，所以文生 3D 是一条链：提示词先进 SDXL 或 Flux 权重，渲染结果作为条件图，形状模型再把它重建出来。概念阶段可以用便宜的 2D 生成反复试，背面不理想时再生成一张图当作额外视图补进去。草图转 3D 走同一条路，用 scribble 或 lineart 的 ControlNet 在低去噪强度下把线稿变成效果图；线稿足够干净时可以直接喂给模型，但更常见的结果是压扁的板片。
从 ComfyUI 预览到 Blender，再到可打印的 STL
- 先把 GLB 导入 Blender，确认单位比例：生成的网格是归一化的，高度约 1 个单位，一个 120 mm 的手办可能需要上千倍缩放。
- 在任何其他操作之前先减面：生成的网格常见落在 20 万到 100 万三角面之间，比例取 0.1–0.3 既保得住轮廓，又让文件可用。
- 修补表面：用 3D-Print Toolbox 检查非流形边，再用 Meshmixer 修复，或者直接让 PrusaSlicer、Bambu Studio 在导入时处理。
- 把壁厚和喷嘴对一下：0.4 mm 喷嘴的 FDM 打印，壁厚常见下限是 0.8–1.2 mm，而生成网格上的耳朵和手指几乎总是更薄。
- 打印导出 STL 或 3MF，进引擎导出 GLB 或 FBX，同时保留原始 GLB。
| 步骤 | 工具 | 常见数值 |
|---|---|---|
| 确定真实尺寸 | Blender 的尺寸字段，或切片软件的缩放输入 | 生成网格高度约 1 个单位，切片前先定成毫米 |
| 降低面数 | Blender 的 Decimate、Meshmixer | 输入 20 万–100 万三角面，输出比例 10–30% |
| 修补网格 | 3D-Print Toolbox、Meshmixer、PrusaSlicer、Bambu Studio | 切片之前做到没有非流形边 |
| 加厚与摆放 | Blender 的 Solidify，切片软件的壁厚设置 | 0.4 mm 喷嘴下壁厚下限 0.8–1.2 mm |
| 需要时再贴图 | AI 贴图流程，或手工绘制 | 机器生成的 UV 做道具够用，做主资产很少够用 |
Open3DAI 站在这组取舍的另一端。它运行一个本地程序化生成引擎，另外可选接第三方引擎适配器，用你自己的 API Key 连接，因此同一个提示词或同一张图可以交给多个引擎，在导出之前并排比较结果。它支持导出 GLB、glTF、OBJ、STL、PLY 和 3MF，另外提供 48 个格式转换器、12 个浏览器工具和 REST API。它不训练也不托管第三方模型，不做绑定、动画、重拓扑、UV 展开和摄影测量，也不承诺导出即可打印、无需清理。需要一张可复现、能挂上研究模型的节点图，选 ComfyUI；需要在今天拿到一个形状和一份能交给切片软件的文件，在线生成通常更快。引擎可用性、积分价格和第三方条款都会变化，投入预算前请以厂商页面为准。
常见问题
只用文字提示词，ComfyUI 能直接生成 3D 模型吗？
光靠 3D 权重本身不行。ComfyUI 里封装的形状模型都以图像为条件，常见做法是在前面接一个 SDXL 或 Flux：提示词先生成图片，图片再作为条件输入。好处是概念阶段可以在 2D 里低成本反复试，只把满意的画面送进 3D 模型。
在 ComfyUI 里跑 Hunyuan3D 需要多少显存？
turbo 和 mini 权重配合卸载通常 8–12 GB 就能跑，完整的形状模型 16 GB 比较宽裕。真正吃显存的是贴图和上色阶段，一般要 24 GB 显卡，所以很多人分批做，或者先导出无贴图网格，再到别处完成材质。
导出的网格为什么像一团乱三角面？
因为它本来就是。这类模型把体素或稀疏潜场解码成表面，得到的是均匀密集的三角面，没有边流向，也没有四边面结构。用来打印和做静态道具没问题，这也正是要先在 Blender 里减面和修补的原因。ComfyUI 里没有任何参数能把它变成可动画的拓扑。
SaveGLB 写出的 GLB 能直接拿去打印吗？
基本都要先过一遍 Blender 或切片软件。第一步是确认单位比例，生成网格是归一化的，不是毫米；然后减面、修补非流形边，并检查细节处是否高于打印机的最小壁厚。PrusaSlicer 和 Bambu Studio 能在导入时修复一部分破损，但没法把一根 0.4 mm 粗的手指加厚。
在 ComfyUI 里应该选 TRELLIS 2 还是 Hunyuan3D？
看哪种失败代价更高。Hunyuan3D 安装更短、节点包更稳定、显存占用更可预测；TRELLIS 对多视图条件的支持更直接，表面通常更干净，UV 也能用。拿不准就先装 Hunyuan3D，完整跑通一次到 STL，再考虑加第二个模型家族做对比。
在 Open3DAI 中试一下
把同一份提示词或图片交给多个引擎，并排对比网格，然后导出 GLB、glTF、OBJ、STL、PLY 或 3MF。注册即赠免费积分，无需信用卡。