Hi3D v1.0 已开源：这项 3D 打印声明究竟需要什么条件

Hi3D v1.0于2026年10月23日在 GitHub 和 Hugging Face 上线，并附带一个数字：90% 切片成功率。这个数字正是3D打印店应当关注此次发布的原因，同时也是该仓库无法复现的那个数字。仓库中没有切片器、没有测试网格、没有基线，也没有对什么算作失败的定义。仓库里实际有的内容相当可观：推理代码、八个权重文件，以及一条流水线，它接收一张参考照片和一个粗糙网格，返回一个稠密得多的网格，有效稀疏提取网格最高可达 1536³。因此，有用的问题不是 Hi3D v1.0 是否有效，而是围绕它必须满足哪些条件，才能最终产出可打印的零件。

具体发布了什么

此次发布是 Sparc3D 的开源——为保持兼容性，Python 包和公共 API 仍沿用 sparc3d 和 Sparc3DPipeline 这两个名称，而其底层论文可追溯至 2025 年 5 月。GitHub 仓库开放时包含六个提交和一个标签；Hugging Face 卡片说明该模型于 2026 年 10 月 23 日发布，并在同一面板中表示它“未由任何 Inference Provider 部署”。v1.0 没有托管端点。商业产品是独立的专有 v3.0，具备 2048³ 几何结构和最高 8K 纹理。

• 仓库包含的内容 — 推理代码、一个演示、Docker 和依赖约束，以及文档。训练代码、论文的评测框架、基准划分，以及主表背后的对比网格均未提供，README 也明确说明了这一点。

• 权重包含哪些内容 — 共八个运行时文件：一个模型索引、一个调度器配置、一个 VAE 配置和 safetensors，以及两个 transformer 配置和 safetensors。图像编码器 facebook/dinov2-large 和 openai/clip-vit-large-patch14 会在首次使用时单独加载，不属于模型目录的一部分。

• 安装方式 — Python 3.10、搭配 CUDA 12.4 的 PyTorch 2.5.0、flash-attn==2.7.4.post1、spconv-cu120==2.3.6，均从源码安装。没有 PyPI wheel，也没有预构建版本。

• 适用哪个许可证 —— Hi3D Open License Agreement 1.0。它不是 OSI 许可证。允许商业使用，但产品或服务若达到每月 200,000 名活跃用户或每月 1,000,000 美元收入，必须在 60 天内通知 Hi3D 并申请单独的书面许可证，且集成必须显示“Powered by Hi3D 1.0”，并在媒介支持链接时附上链接。

发布报道的定位是，这是一款“工业生产级”的图像转3D模型。厂商自己的公告页面确实声称，它“已在真实生产工作流中得到验证”，并且评估涵盖了多视角外观、局部细节和几何可用性。但文中没有点名任何一家客户、任何一个工作流，也没有给出任何实测输出。这是关于生产的断言，而非生产的证据。

印刷权利要求，拆分为四项要求

从打印机上取下来的零件必须满足四点，而这四点与渲染效果看起来有多惊艳毫无关系。Hi3D v1.0 很好地解决了其中一点，部分解决了另一点，还有两点完全没解决。

• 比例——有意为之，已不复存在。输出会重新居中，并归一化到单位最大半径。绝对尺寸和世界坐标不会被保留，因此每个模型都必须重新缩放到毫米，才有实际意义。如果你的参考照片来自真实物体，而你需要它的真实尺寸，Hi3D 不会把这些尺寸传递下来。仓库明确说明了这一点，而不是默不作声，这值得肯定，但这意味着比例是需要你自己处理的一步。

• 拓扑 —— 继承自输入，未作修复。Hi3D 接收一个粗网格并为其添加细节。如果该粗网格存在非流形边、自相交或法线反转，细化只会让这些缺陷更精细，而不会修正它们。README 自身的局限性部分写道“粗结构很重要”，并且严重的粗网格错误可能会持续存在。切片软件仍然会在同样的缺陷上卡住，只是分辨率更高。对于任何要把它用于打印机的人来说，这是本次发布中最重要的一句话。

• 表面——缺失。输出是仅含几何的 trimesh.Trimesh：没有纹理、没有材质、没有顶点颜色。对于单材料打印来说，这基本不成问题，因为你打印的是材料，而不是 UV 贴图。但对于任何需要上色或多色结果的情况，或者对于必须看起来像产品实物的客户预览来说，这就是致命缺陷，会迫使你转向 v3.0。

• 可打印性 — 未评估。代码仓库中没有任何内容测量壁厚、最小特征尺寸、悬垂结构，或细化后网格是否水密。90% 的切片数字出现在新闻稿中，而非代码中，且未指明任何切片软件。切片文件也不等同于打印出的零件：切片成功并不能说明打印会附着、能在支撑下成功打印，或保持公差。

这些数字，按实际支撑它们的因素排序

这份发布把支持程度差异极大的各种说法混在一起。把它们笼统地归为一类，正是厂商给出的数字在采购决策中变成“事实”的方式。

• 约两百万个精选 3D 资产——新闻稿和模型卡中是这样说的，且与 Sparc3D 系列一致，早先的论文将其描述为大约 50 万个资产。你无法从仓库审计其筛选过程，因为数据集和训练代码都未随附发布。应将其视为可信的厂商数字，而非经过验证的数字。

• 1536³ 有效分辨率 — 作为一种配置，这一点是真实存在的。流水线对 512³ 运行一遍，对 1024³ 运行两遍，对 1536³ 运行三遍，默认每遍进行 25 次调度器更新。“effective”（有效）这个词很重要：这些是名义上的稀疏坐标网格和提取网格，而不是稠密的 1536³ 潜变量张量。README 还指出，1536³ 设置仅在 96 GB H20 上验证过，而在较小显卡上的可行性和峰值内存尚未说明。

• 90% 切片成功率——厂商报告，未经复现，且未说明方法。没有切片器，没有失败定义，没有基线，也没有测试集。这是发布中最常被引用的数字，也是最难核实的数字。

• 最高的多视角保真度与细节丰富度 —— 以“所报告的评估”结果的形式呈现，而该评估并不在代码库中。没有对比表，没有竞品清单，也没有按类别划分的细分数据。

• "已在真实生产工作流中得到验证"——这是公告页面上的一句话，没有点名任何合作方，没有案例研究，也没有描述具体的工作流。它很可能属实，但尚不足以构成证据。

硬件壁垒

实测配置是一台 96 GB 的 NVIDIA H20，仓库也如实说明，最高设置正是在这台机器上验证的。周边要求同样具体：Linux、计算能力 8.0 或更高、CUDA 12.0 到 12.5，并且完全没有 CPU 推理路径。flash-attn 没有可回退的注意力实现，因此它一旦构建失败就是致命问题，而不是降级运行。批大小为 1。

支持顺序 CPU 卸载，并可降低 GPU 常驻占用，但 README 特意说明：这并不确立最低 GPU 显存要求，也不会消除解码特征带来的成本。实际上，这意味着 512³ 单遍路径或许能在 24 GB 显卡上运行，但尚无人发布显存占用表，厂商也未作出此类声明。如果你的方案依赖 4090，那你运行的是未经验证的配置，在正式投入前应自行计时并测量。

一个正常工作的打印流水线是什么样子

Hi3D v1.0 只有一个阶段。该仓库附带一个可选适配器，使用腾讯的 Hunyuan3D-2 mini 从单张图像生成粗网格；Hunyuan 属于第三方，不是核心库的依赖项，但如果没有类似的东西，你就没有输入。

所以真正的流程是：生成或获取一个粗糙网格，用 Hi3D 在 512³、1024³ 或 1536³ 下对其进行细化，导出几何体，将其重新缩放到真实尺寸，修复粗阶段弄错的任何拓扑，验证水密性，然后进行切片。其中三个步骤——修复、水密性、切片——在该发布版本中没有任何对应功能，而第一个步骤才是大多数失败实际会发生的地方。

OrcaRouter 不托管 Hi3D v1.0 或任何其他 3D 模型，也不会通过 API 调用返回可打印的网格。它托管的是围绕流水线的文本和视觉工作：编写对象简报、为参考照片生成说明，以及在你在 1536³ 渲染上耗费 GPU 时间之前，检查多视图渲染是否存在缺陷。这就是一个端点支持 200 多个模型，并具备自动故障转移，当周边检查正是你不想自己构建的部分时，这会很有用。3D 步骤仍在你自己的硬件上进行。

本周谁应该下载它？

如果你在生产环境中已经有一个粗网格生成器——Hunyuan3D-2 mini、TripoSR 或自研环节——而瓶颈在于网格看起来偏软，那么 Hi3D v1.0 值得投入一天 GPU 时间。512³ 路径是起点；1536³ 路径需要厂商所用的 H20 级显卡。

如果你的要求是“输入一张照片，输出可打印的零件”，那么这个版本做不到这一点，围绕它的营销宣传也做不到。你仍然需要第一阶段、修复阶段和切片软件，而那个 90% 的数字并不能套用到你的物体、你的材料或你的打印机上。

如果你需要纹理、颜色或面向客户的渲染，请等待 v3.0 或改用其他方案。仅支持几何体是一条硬性边界，而不是临时缺失。

真正能改变结论的东西既窄又具体：一个有名字的切片器、一个公开的测试集、一套失败分类法，以及一个基线——最好是未经细化的粗网格，好让读者看清细化究竟换来了什么。一张覆盖全部三种分辨率、且跑在不止一块 GPU 上的内存与延迟表，就能把硬件方面的疑问了结掉。在其中任何一项出现之前，对 Hi3D v1.0 最诚实的描述是：一个强大且真正开放的几何细化器，外加一项抢在证据之前就硬挂上去的量产主张。