hi3d-official/Hi3Dv1.0

这是什么？

核心功能

• 01以同一物体的参考图为条件，细化粗糙网格。
• 02支持 512、1024、1536 三档分辨率输出高精度几何。
• 03可直接从 Hugging Face 或本地目录加载模型权重。
• 04同时提供 Python 接口和命令行脚本。
• 05支持顺序 CPU 卸载以降低显存占用，并可通过回调查看进度。

适用场景

• 为 3D 生成模型输出的网格补充更精细的表面细节。
• 依据参考照片细化低模或粗糙模型。
• 在 3D 资产处理流程中批量细化已有网格。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/hi3d-official/Hi3Dv1.0.git
2. 2

   进入项目目录

   cd Hi3Dv1.0
3. 3

   安装 CUDA 12.4 版 PyTorch（之后按 README 安装 flash-attn）

   pip install torch==2.5.0+cu124 torchvision==0.20.0+cu124 --extra-index-url https://download.pytorch.org/whl/cu124
4. 4

   从源码安装项目及推理依赖

   pip install -c docker/constraints.txt -e ".[inference]"

使用前须知

• !仅支持 Linux，且需要计算能力 8.0 或更高的 NVIDIA GPU，没有 CPU 推理路径。
• !1536 分辨率仅在 96 GB 的 NVIDIA H20 上验证，较小显卡未经验证。
• !商业使用需遵循自定义的 Hi3D 开源许可协议，该协议设有用户数与收入门槛及品牌标注要求。
• !仅支持从源码安装，没有 PyPI 发布版，并需要匹配的 CUDA 工具包和 flash-attn 编译环境。

标签

常见问题

Hi3Dv1.0 是什么？

开源的 3D 几何精修推理代码与模型权重，可依据参考图将粗糙网格细化为高分辨率几何。 Hi3D v1.0 接收一个粗糙网格和同一物体的参考图，输出经过细化的高分辨率网格。它基于 Sparc3D 的稀疏表示，逐步采样稀疏 latent，经稀疏 VAE 解码后提取网格，最多进行三轮迭代。

Hi3Dv1.0 可以免费使用吗？用的什么许可证？

Hi3Dv1.0 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

Hi3Dv1.0 还在维护吗？

活跃维护中。Hi3Dv1.0 最近一次提交是在 2026年10月23日。

Hi3Dv1.0 适合用来做什么？

为 3D 生成模型输出的网格补充更精细的表面细节。 依据参考照片细化低模或粗糙模型。 在 3D 资产处理流程中批量细化已有网格。

Hi3Dv1.0 怎么安装和运行？

克隆仓库: git clone https://github.com/hi3d-official/Hi3Dv1.0.git 进入项目目录: cd Hi3Dv1.0 安装 CUDA 12.4 版 PyTorch（之后按 README 安装 flash-attn）: pip install torch==2.5.0+cu124 torchvision==0.20.0+cu124 --extra-index-url https://download.pytorch.org/whl/cu124 从源码安装项目及推理依赖: pip install -c docker/constraints.txt -e ".[inference]"

在哪里获取 Hi3Dv1.0？

源代码和安装说明在 GitHub 上：https://github.com/hi3d-official/Hi3Dv1.0