TRELLIS.2：微软 4B 图生 3D 模型，PBR 材质与 GLB 导出入门

图片来源：Microsoft TRELLIS.2 官方 GitHub README。资料核对时间：2026-06-11。

TRELLIS.2 是微软开源的 3D 生成项目，定位是高保真 Image-to-3D。它的关键词很明确：4B 参数、O-Voxel、复杂拓扑、PBR 材质、GLB 导出。如果你关注 AI 3D 模型、游戏资产、室内家具资产、虚拟样板间，它是非常值得跟踪的前沿项目。

项目地址：
https://github.com/microsoft/TRELLIS.2

项目主页：
https://microsoft.github.io/TRELLIS.2

Hugging Face Demo：
https://huggingface.co/spaces/microsoft/TRELLIS.2

模型地址：
https://huggingface.co/microsoft/TRELLIS.2-4B

它和普通图生 3D 有什么不同？

TRELLIS.2 官方介绍里提到，它使用一种叫 O-Voxel 的稀疏 3D 结构，不依赖传统 iso-surface field，因此能更好处理复杂拓扑和开放表面。

这意味着它理论上更适合：

• 服装、叶片、镂空结构等开放表面。
• 非流形几何。
• 带内部结构或复杂边界的物体。
• 需要透明度、金属度、粗糙度等 PBR 属性的资产。

对室内设计来说，家具、灯具、摆件、装饰件、布艺软装都可能受益。

输出格式：GLB 和 PBR

官方用法里提到，TRELLIS.2 可以生成：

• sample.mp4：用于预览 3D 资产的视频。
• sample.glb：带 PBR 材质的 3D 资产。

GLB 的好处是通用性强，可以放进 Blender、Three.js、Unity、Unreal 或 Web 展示系统里继续处理。

硬件门槛

TRELLIS.2 比很多轻量图生 3D 项目更“硬核”。官方 README 写明：

• 当前代码主要在 Linux 测试。
• 需要 NVIDIA GPU。
• 至少 24GB 显存。
• 推荐 CUDA Toolkit 12.4。
• Python 3.8 或以上。

如果你只是普通设计师，建议先用 Hugging Face Demo 看效果；如果你是技术团队，可以考虑本地部署。

安装教程

克隆仓库：

git clone -b main https://github.com/microsoft/TRELLIS.2.git --recursive
cd TRELLIS.2

使用官方脚本创建环境并安装依赖：

. ./setup.sh --new-env --basic --flash-attn --nvdiffrast --nvdiffrec --cumesh --o-voxel --flexgemm

如果显卡不支持 flash-attn，可以参考官方说明改用 xformers。

最小使用示例

官方仓库提供了 example.py，核心流程可以理解为：

1. 读取一张输入图。
2. 加载 TRELLIS.2-4B 模型。
3. 生成 3D 资产。
4. 导出预览视频和 GLB 模型。

示例中会使用环境贴图渲染，并导出 sample.glb。

本地 Web Demo

官方也提供了简单 Web Demo：

python app.py

启动后按终端提示打开本地地址，即可上传图片生成 3D 资产。

适合写进哪些工作流？

室内设计资产库：把单品图转成可预览模型。
电商 3D 展示：从产品图生成模型初稿。
游戏/影视概念资产：快速把设计图变成 3D 草模。
Web 3D 页面：生成 GLB 后放入 Three.js 做交互展示。

和 Hunyuan3D-2.1 怎么选？

简单理解：

• Hunyuan3D-2.1：更适合先试用，官方强调生产级 PBR 管线，社区生态也在快速扩展。
• TRELLIS.2：更偏前沿研究和高质量 3D 生成，对硬件和部署环境要求更高。

如果你是设计师，先用在线 Demo；如果你是 AI 3D 技术团队，TRELLIS.2 值得本地研究。

注意事项

• 24GB 显存是现实门槛，不建议低配机器硬跑。
• 生成资产仍需要人工检查拓扑、比例、材质和法线。
• 商业使用前请确认 MIT 代码许可证、模型卡和相关第三方依赖许可证。

资料来源

• GitHub：https://github.com/microsoft/TRELLIS.2
• Project Page：https://microsoft.github.io/TRELLIS.2
• Hugging Face Demo：https://huggingface.co/spaces/microsoft/TRELLIS.2
• Hugging Face Model：https://huggingface.co/microsoft/TRELLIS.2-4B
• Paper：https://arxiv.org/abs/2512.14692
• 图片来源：Microsoft TRELLIS.2 官方 README