TRELLIS.2 ComfyUI:从一张图片到 PBR 3D 模型

用一张图片生成几何和材质,再在同一套 ComfyUI 工作流中完成重建网格、减面、UV 展开和贴图烘焙。TRELLIS.2 与 Pixal3D 已原生接入核心节点。

ComfyUI 官方 TRELLIS.2 与 Pixal3D 共用模板预览图
官方 TRELLIS.2 与 Pixal3D 共用模板的预览图。 ComfyUI

原生集成省去了早期社区工作流中单独安装自定义节点的步骤。官方模板同时包含两个模型,通过开关选择 TRELLIS.2。生成几何只是第一步,后续网格清理和材质烘焙能让结果更方便进入 3D 编辑器。

这套原生工作流能生成什么

TRELLIS.2 使用 40 亿参数的图片转 3D 模型和 O-Voxel 结构化潜变量。管线依次生成稀疏结构、细化形状,再生成基础色、金属度和粗糙度材质。

原生工作流增加了网格重建、减面、UV 展开以及法线和 AO 烘焙。当原始网格很精细,但交付需要更小的模型和完整贴图时,这些步骤尤其有用。

加载模板,并切换到 TRELLIS.2

更新 ComfyUI,在模板库打开“Pixal3D & TRELLIS.2: Image to Model”。按照模板说明下载模型,再把清晰的物体图片加载到 LoadImage。

把 Boolean (Switch to Trellis2) 设为 true。共用模板默认使用 Pixal3D,未切换时运行的是另一个模型。提交队列后,在 Preview3DAdvanced 查看结果;官方教程将模型保存到 ComfyUI/output/3d/ComfyUI/。

官方示例输入:具有清晰主体轮廓的符文斧头。
官方示例输入:具有清晰主体轮廓的符文斧头。 ComfyUI

把模型放进正确的目录

模板可以切换两条管线,因此需要下载两个扩散模型。形状与纹理 VAE、DINOv3 图片条件模型及 BiRefNet 去背景组件是共用的。

按照下面的文件名与目录存放。节点缺失通常与 ComfyUI 版本过旧或启动导入失败有关;检查点缺失则要单独检查模型路径。

ComfyUI/models/
├── diffusion_models/
│   ├── trellis_2_int8_convrot.safetensors
│   └── pixal3d_int8_convrot.safetensors
├── vae/
│   ├── trellis_2_shape_vae_bf16.safetensors
│   └── trellis_2_texture_vae_bf16.safetensors
├── clip_vision/
│   └── dino_v3_L_naf_fp32.safetensors
└── background_removal/
    └── birefnet.safetensors

导出前检查网格和材质

先检查轮廓、细薄结构、孔洞和面数,再决定最终交付版本。网格重建与减面解决的是不同问题:前者重建表面连接关系,后者压缩模型的面数预算。

模型生成基础色、金属度和粗糙度;ComfyUI 实现中的法线与环境遮蔽贴图来自高精度网格烘焙。建议在 3D 编辑器的中性光照下检查,不要只看明亮的预览图。

共用模板中的 TRELLIS.2 与 Pixal3D

设置TRELLIS.2Pixal3D
模板开关Boolean (Switch to Trellis2) = true开关为 false 时的默认管线
扩散模型trellis_2_int8_convrot.safetensorspixal3d_int8_convrot.safetensors
图片条件TRELLIS.2 条件方式像素对齐条件方式
共用阶段形状/纹理 VAE 与网格处理形状/纹理 VAE 与网格处理

常见问题

还需要安装 TRELLIS.2 自定义节点包吗?

这套原生工作流不需要,模型使用 ComfyUI 核心节点。旧的第三方工作流可能仍依赖自定义节点,所以应使用当前官方模板。

需要多少显存?

微软参考实现要求至少 24GB NVIDIA 显存。ComfyUI 的占用还受分辨率、精度和模型卸载设置影响。显存不足时,先降低生成分辨率,再检查内存管理设置。

为什么提示缺少节点或模型?

先更新 ComfyUI,查看启动日志是否导入失败,再确认模型所在目录。官方文档也提醒,新核心节点在稳定版发布前可能需要 Nightly 版本。

法线和 AO 是 TRELLIS.2 直接预测的吗?

原生工作流从高精度网格烘焙这两类贴图。TRELLIS.2 材质模型生成基础色、金属度和粗糙度,烘焙阶段扩展最终贴图集合。

官方资料

无需配置本地环境,直接生成模型

只需要一个资产时,可以在浏览器中使用图片转 3D 生成器,无需管理本地工作流。

生成 3D 资产