Supra-3D/SUPRA-Tex

这是什么？

核心功能

• 01生成包含基础色、金属度和粗糙度贴图的 GLB 资产。
• 02在可见表面上保留输入图片中的文字、图案和材质边界。
• 03通过 Interleaved Flow Transformer 补全不可见区域的纹理。
• 04可为已有网格贴图，需提供相机、前景图和材质图。
• 05提供本地 Gradio 网页应用和命令行脚本。
• 06提供可选的纹理精修和遮挡边界深度预过滤。

适用场景

• 从产品照片或参考图片制作带纹理的 3D 道具或资产。
• 为已有几何和相机数据的网格补全 PBR 纹理。
• 制作需要在 3D 引擎或渲染器中重新打光的 PBR 资产。
• 在单块 NVIDIA GPU 上试验单图生 3D。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/Supra-3D/SUPRA-Tex.git
2. 2

   在已激活的 Conda 环境中安装运行时（需要 Python 3.10 以及带 nvcc 的 CUDA 12.4）

   python scripts/install_runtime.py --conda
3. 3

   登录 Hugging Face，获得 DINOv3 访问批准后下载模型

   python scripts/prepare_models.py
4. 4

   运行自带示例，生成带纹理的 GLB 文件

   python scripts/run_example.py --output outputs/spiny_whelk_shell.glb

使用前须知

• !需要 Linux 系统和 NVIDIA GPU，并安装 CUDA 12.4 工具包。
• !图像转 3D 流程依赖 DINOv3，需要在 Hugging Face 上申请访问批准。
• !没有透明通道的 RGB 图像还需要 RMBG-2 或 BiRefNet 模型。

标签

常见问题

SUPRA-Tex 是什么？

从单张图片生成带纹理、可重新打光的 3D 资产（GLB 格式，含基础色、金属度和粗糙度贴图），也可为已有网格贴图。 SUPRA-Tex 可以将单张图片转换为采用基于物理的渲染（PBR）材质的 3D 资产。它在参考视角中预测材质，将其编码为与表面对齐的 3D 观测，再由 Interleaved Flow Transformer 补全相机看不到的区域。目标是把输入图片中的文字、图案和材质边界等细节保留在可见表面上。

SUPRA-Tex 可以免费使用吗？用的什么许可证？

SUPRA-Tex 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

SUPRA-Tex 还在维护吗？

活跃维护中。SUPRA-Tex 最近一次提交是在 2026年10月29日。

SUPRA-Tex 适合用来做什么？

从产品照片或参考图片制作带纹理的 3D 道具或资产。 为已有几何和相机数据的网格补全 PBR 纹理。 制作需要在 3D 引擎或渲染器中重新打光的 PBR 资产。 在单块 NVIDIA GPU 上试验单图生 3D。

SUPRA-Tex 怎么安装和运行？

克隆仓库: git clone https://github.com/Supra-3D/SUPRA-Tex.git 在已激活的 Conda 环境中安装运行时（需要 Python 3.10 以及带 nvcc 的 CUDA 12.4）: python scripts/install_runtime.py --conda 登录 Hugging Face，获得 DINOv3 访问批准后下载模型: python scripts/prepare_models.py 运行自带示例，生成带纹理的 GLB 文件: python scripts/run_example.py --output outputs/spiny_whelk_shell.glb

在哪里获取 SUPRA-Tex？

源代码和安装说明在 GitHub 上：https://github.com/Supra-3D/SUPRA-Tex