TRELLIS.2

TRELLIS.2

Comfy-Org 重新打包的微软 TRELLIS.2-4B 模型文件，供 ComfyUI 使用，用于图片转模型工作流，适合从图片构建 3D 资产的人。

由 Comfy-Org 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Comfy-Org 的 TRELLIS.2 是一组给 ComfyUI 用的模型文件，由 microsoft/TRELLIS.2-4B 重新打包而来。文件包括主扩散模型、一个视觉编码器和两个 VAE，一个管形状，一个管纹理。

仓库链接了一个名为 Pixal3D and TRELLIS.2, Image to Model 的 ComfyUI 工作流。这个名字指向从图片制作 3D 模型，模型卡也是这样描述的。

适合谁：它适合想用已经按 ComfyUI 要求摆好的文件来试用基于图片的 3D 生成的 ComfyUI 用户。它不是独立程序。

行业 | 谁在用 | 怎么用 | 例子
游戏和媒体 | 3D 美术师 | 从参考图片起步制作 3D 资产 | 根据概念图起草一个道具
产品设计 | 设计师 | 把产品照片变成第一版 3D 模型 | 一个小设备的粗略模型
创意工具 | ComfyUI 用户 | 给节点工作流加上 3D 生成 | 一个图片转模型的节点图
研究 | 图形学研究者 | 在 ComfyUI 里运行 TRELLIS.2 模型 | 对比 bf16 和 int8 文件

如果你不用 ComfyUI，可以跳过它，因为这些文件是为那个应用打包的。

用在哪里：

• ComfyUI，放在它的 models 文件夹里
• 模型卡链接的 Pixal3D and TRELLIS.2 图片转模型工作流
• Windows、macOS 或 Linux，下载步骤需要 Python

用例 | 谁用 | 得到什么
图片转 3D 模型 | 3D 美术师和设计师 | 由输入图片生成的 3D 模型
工作流复用 | ComfyUI 用户 | 一个可以直接加载运行的节点图

如何设置：先准备好下面这些东西。

• 你电脑上装好的 ComfyUI
• Python 和 pip，用于下载命令
• 你选的文件所需的磁盘空间

1. 用 pip 安装 Hugging Face hub 包。
2. 用 hf 命令下载仓库。
3. 按下面的列表，把每个文件复制到对应的 ComfyUI models 文件夹。
4. 在 ComfyUI 里加载图片转模型工作流。

pip install -U huggingface_hub
hf download Comfy-Org/TRELLIS.2

模型卡列出了每个文件放在哪里。三个文件夹都在 ComfyUI 的 models 文件夹里。

• clip_vision 文件夹放 dino_v3_vit_l.safetensors
• diffusion_models 文件夹放 trellis_2_int8_convrot.safetensors 和 trellis_2_bf16.safetensors
• vae 文件夹放 trellis_2_shape_vae_bf16.safetensors 和 trellis_2_texture_vae_bf16.safetensors

如何使用：你打开 ComfyUI，加载图片转模型工作流，把它的节点指向这些文件，再给它一张图片。模型卡除了下载之外没有给出命令，所以其余由工作流本身来引导。

工具 | 作用
dino_v3_vit_l | 读取输入图片的视觉编码器
trellis_2_bf16 | bf16 精度的扩散模型
trellis_2_int8_convrot | 名称里带 int8 的扩散模型文件
trellis_2_shape_vae_bf16 | 负责形状的 VAE
trellis_2_texture_vae_bf16 | 负责纹理的 VAE

示例：你把五个文件放进各自的 ComfyUI 文件夹，加载 Pixal3D and TRELLIS.2 图片转模型工作流。你提供一张物体的图片。工作流运行后返回它的 3D 模型。

新手与专家：先用 bf16 扩散文件和链接的工作流，并且只用一张清楚的单个物体图片。想要更小的文件时，之后再试 int8 文件。

重新打包把模型拆成 ComfyUI 期望的几块，所以视觉编码器、扩散模型和两个 VAE 作为独立节点加载。形状和纹理两个 VAE 暗示几何和表面是分开处理的。模型卡没有给出大小或基准，所以请在你自己的图片上测试。

用 hf 下载文件
复制到 ComfyUI 文件夹
加载图片转模型工作流
给它一张图片，得到 3D 模型

注意事项：

• License: MIT
• Cost to run: 来源没有提到
• Data it reaches: 它把文件从 Hugging Face 下载到你的电脑上

Hugging Face 上的数据（2026年11月13日）

• 框架：diffusion-single-file
• 最近 30 天下载：377,945
• 点赞：110
• 许可证：mit
• 基于：microsoft/TRELLIS.2-4B
• 标签：diffusion-single-file, comfyui

链接

• 模型：https://huggingface.co/Comfy-Org/TRELLIS.2
• 文件：https://huggingface.co/Comfy-Org/TRELLIS.2/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download Comfy-Org/TRELLIS.2

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。