TRELLIS.2：ComfyUI 单图生成带 PBR 纹理的 3D 模型

在 ComfyUI 中用微软开源的 4B 参数 TRELLIS.2，从单张图像生成带完整 PBR 纹理的 3D 模型，同一工作流内置 Pixal3D。

TRELLIS.2 是微软研究院推出的开源图生3D模型，也是 TRELLIS 的继任者。它是一个 4B 参数模型，基于原生3D VAE 构建，具有 16× 空间压缩，并采用名为 O-Voxel 的稀疏体素表示，可从单张图像生成带有完整 PBR 材质的精细3D资产。

TRELLIS.2 与 Pixal3D 共享基础架构：两者使用相同的 DINOv3 图像编码器、相同的形状和纹理 VAE，以及相同的结构、形状和纹理生成阶段。只有主要的扩散模型和条件格式有所不同。如果你已经运行过 Pixal3D 工作流，模型设置几乎完全相同。

TRELLIS.2：图像到3D模型

上传单张图像。使用 TRELLIS.2 生成带有完整 PBR 纹理的高保真3D模型。

该工作流同时包含 Pixal3D 管线。要运行 TRELLIS.2,将 Boolean (Switch to Trellis2) 节点设为 true,工作流会自动切换到 TRELLIS.2 模型和条件。

[!TIP] > [tab] 本地用户 > > 请确保你的 ComfyUI 已经更新。 > > ComfyUI 下载 > ComfyUI 更新教程 > > 本指南里的工作流可以在工作流模板中找到。如果找不到，可能是 ComfyUI 没有更新。 > > 如果加载工作流时有节点缺失，可能原因有： > > 1. 你用的不是最新版（每夜版）。 > 2. 启动时有些节点导入失败。 > [tab] 云端用户 > > * Cloud 会在 ComfyUI 稳定版本发布后更新。 > > 所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。

[card] 在 Comfy Cloud 上运行 立即在 Comfy Cloud 上运行此工作流

[card] 下载工作流 下载 JSON，或在模板库中搜索“Pixal3D & TRELLIS.2: Image to Model”

输入素材

将此文件上传到 LoadImage 节点：

[card] viking\_wolf\_rune\_axe.png LoadImage 节点 122 · viking_wolf_rune_axe.png

工作原理

TRELLIS.2 通过三个扩散阶段生成 3D 资产,然后运行完整的网格后处理管线:

1. 背景移除: BiRefNet 移除输入图像的背景,工作流将主体裁剪到居中的 1024×1024 画布。可通过开关跳过背景移除
2. 切换到 TRELLIS.2 管线:将 Boolean (Switch to Trellis2) 设为 true,工作流会自动加载 TRELLIS.2 模型
3. 结构生成: 采样稀疏结构潜变量,解码为体素,再转换为粗略网格
4. 形状细化: 形状阶段和上采样阶段将网格细化到目标分辨率(1536)
5. 纹理生成: 纹理扩散阶段生成 PBR 材质体素(基色、金属度、粗糙度)
6. 后处理: DC 网格重建、QEM 减面、UV 展开,以及将基色、法线和环境光遮蔽贴图烘焙到最终带纹理的网格

运行步骤

1. 加载图像：使用 LoadImage 节点加载对象的单个图像
2. 将工作流加入队列：按 Ctrl（macOS 上为 Cmd）+ Enter
3. 等待工作流执行：结构、形状和纹理阶段依次运行，随后进行后处理
4. 查看结果：在 Preview3DAdvanced 节点中检查网格。GLB 文件将保存到 ComfyUI/output/3d/ComfyUI/

模型下载

下载此工作流使用的模型。两个扩散模型都需要:开关会决定运行哪一个。放到对应的 models/ 子目录中。

[card] TRELLIS.2 UNet 模型 trellis\_2\_int8\_convrot.safetensors: TRELLIS.2 扩散模型(开关设为 true 时加载)

[card] Pixal3D UNet 模型 pixal3d\_int8\_convrot.safetensors: Pixal3D 扩散模型(默认加载)

[card] 形状 VAE trellis\_2\_shape\_vae\_bf16.safetensors: 用于结构和形状解码的 VAE

[card] 纹理 VAE trellis\_2\_texture\_vae\_bf16.safetensors: 用于纹理解码的 VAE

[card] DINOv3 CLIP 视觉编码器 dino\_v3\_L\_naf\_fp32.safetensors: 用于图像条件的 CLIP 视觉编码器。TRELLIS.2 仓库中等价的 dino\_v3\_vit\_l.safetensors 同样可用

[card] BiRefNet 背景移除 birefnet.safetensors: 用于预处理的背景移除模型

模型存储位置

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │      ├── pixal3d_int8_convrot.safetensors
│   │      └── trellis_2_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