TencentARC/Pixal3D · Hugging Face

来源：https://huggingface.co/TencentARC/Pixal3D

Pixal3D 能够从单张图像生成高保真度的3D资产。与以往通过注意力机制松散注入图像特征的方法不同，Pixal3D 通过反投影将像素特征显式提升至3D空间，建立起直接的像素到3D的对应关系。这使得模型能够实现近乎重建级别的保真度，拥有精细的几何结构以及 PBR 纹理。

✨ 新闻

• 2026年5月：发布基于 Trellis.2 (https://github.com/microsoft/TRELLIS.2) 主干网络的改进版本。💪
• 2026年5月：发布推理代码和在线演示。🤗
• 2026年4月：我们的论文被 SIGGRAPH 2026 收录！🎉

📌 分支

如果你希望复现论文中的结果，请切换到 paper 分支。

🎮 在线试用

你可以通过我们的 Hugging Face Gradio 演示，直接在浏览器中试用 Pixal3D，无需任何安装：

👉 启动演示 (https://huggingface.co/spaces/TencentARC/Pixal3D)

🚀 快速开始

安装

步骤1：按照 Trellis.2 安装说明操作

请先按照 Trellis.2 (https://github.com/microsoft/TRELLIS.2) 的安装指南设置好基础环境。

步骤2：安装额外依赖项

pip install -r requirements.txt

步骤3：安装 utils3d

pip install https://github.com/LDYang694/Storages/releases/download/20260430/utils3d-0.0.2-py3-none-any.whl

使用

推理

从单张图像生成 GLB 网格：

python inference.py --image assets/test_image/0.png --output ./output.glb

Web 演示

我们为 Pixal3D 提供了一个 Gradio Web 演示，可以让您以交互方式从图像生成 3D 网格。

python app.py

🤗 致谢

本项目大量基于 Trellis.2 (https://github.com/microsoft/TRELLIS.2) 和 Direct3D-S2 (https://github.com/DreamTechAI/Direct3D-S2)。同时感谢以下仓库的杰出贡献：Trellis (https://github.com/microsoft/TRELLIS)。

📄 引用

如果你觉得本工作有用，请考虑引用：

@article{li2026pixal3d,
    title   = {Pixal3D: Pixel-Aligned 3D Generation from Images},
    author  = {Li, Dong-Yang and Zhao, Wang and Chen, Yuxin and Hu, Wenbo and Guo, Meng-Hao and Zhang, Fang-Lue and Shan, Ying and Hu, Shi-Min},
    journal = {arXiv preprint arXiv:2605.10922},
    year    = {2026}
}