Hi3D v1.0 là mã nguồn mở: Tuyên bố về in 3D thực sự đòi hỏi điều gì

Hi3D v1.0 đã được đăng lên GitHub và Hugging Face vào ngày 23 tháng 10 năm 2026, gắn liền với một con số duy nhất: 90% tỷ lệ cắt lớp thành công. Con số đó chính là toàn bộ lý do khiến một xưởng in 3D phải quan tâm đến bản phát hành này, và cũng chính là con số duy nhất mà kho mã nguồn không thể tái lập được. Trong đó không có slicer, không có lưới kiểm thử, không có đường cơ sở, và cũng không có định nghĩa nào cho việc thế nào thì bị tính là thất bại. Những gì thực sự nằm trong repo thì không hề ít: mã suy luận, tám tệp trọng số, và một pipeline nhận vào một bức ảnh tham chiếu cùng một lưới thô rồi trả về một lưới dày đặc hơn nhiều, với lưới trích xuất thưa hiệu dụng lên tới 1536³. Vậy nên câu hỏi hữu ích không phải là liệu Hi3D v1.0 có hoạt động hay không, mà là những gì phải đúng xung quanh nó thì mới cho ra được một chi tiết có thể in ở đầu bên kia.

Chính xác thì đã phát hành những gì

Bản phát hành này là việc mở mã nguồn Sparc3D — gói Python và API công khai vẫn giữ các tên sparc3d và Sparc3DPipeline để tương thích, và bài báo nền tảng có từ tháng 5 năm 2025. Kho lưu trữ GitHub khởi đầu với sáu commit và một tag duy nhất; thẻ mô hình trên Hugging Face cho biết mô hình được phát hành vào ngày 23 tháng 10 năm 2026 và, trong cùng khung thông tin đó, rằng mô hình “không được triển khai bởi bất kỳ Inference Provider nào.” Không có endpoint được host nào cho v1.0. Sản phẩm thương mại là một v3.0 riêng biệt, độc quyền với hình học 2048³ và kết cấu lên đến 8K.

• Kho lưu trữ có gì — mã suy luận, một bản demo, các ràng buộc về Docker và phụ thuộc, cùng tài liệu. Mã huấn luyện, bộ khung đánh giá của bài báo, các phân chia benchmark và các lưới so sánh đằng sau bảng kết quả chính đều không có, và README nói rõ điều đó.

• Trọng số gồm những gì — tám tệp runtime: một chỉ mục mô hình, một cấu hình scheduler, một cấu hình VAE và safetensors, cùng hai cấu hình transformer và safetensors. Các bộ mã hóa hình ảnh, facebook/dinov2-large và openai/clip-vit-large-patch14, được tải riêng trong lần sử dụng đầu tiên và không thuộc thư mục mô hình.

• Cách bạn cài đặt nó — Python 3.10, PyTorch 2.5.0 với CUDA 12.4, flash-attn==2.7.4.post1, spconv-cu120==2.3.6, được cài đặt từ mã nguồn. Không có wheel trên PyPI và không có bản phát hành dựng sẵn.

• Giấy phép nào được áp dụng — Thỏa thuận Giấy phép Mở Hi3D 1.0. Đây không phải là giấy phép OSI. Việc sử dụng cho mục đích thương mại được cho phép, nhưng một sản phẩm hoặc dịch vụ vượt quá 200.000 người dùng hoạt động hàng tháng hoặc 1.000.000 USD doanh thu hàng tháng phải thông báo cho Hi3D và xin một giấy phép bằng văn bản riêng trong vòng 60 ngày, và các tích hợp phải hiển thị "Powered by Hi3D 1.0" kèm liên kết ở những phương tiện có hỗ trợ.

Cách đóng khung trong các bài đưa tin về bản phát hành là đây là một mô hình image-to-3D "đạt chuẩn sản xuất công nghiệp". Trang thông báo của chính nhà cung cấp có tuyên bố rằng nó đã được "kiểm chứng trong các quy trình sản xuất thực tế" và rằng việc đánh giá bao gồm diện mạo đa góc nhìn, chi tiết cục bộ và tính khả dụng hình học. Nó không nêu tên một khách hàng, quy trình làm việc hay kết quả đo lường nào. Đó là một khẳng định về sản xuất, không phải bằng chứng về điều đó.

Tuyên bố về in ấn, được chia thành bốn yêu cầu

Một chi tiết in ra từ máy in phải đáp ứng bốn yếu tố không liên quan gì đến việc hình render trông ấn tượng đến đâu. Hi3D v1.0 giải quyết tốt một yếu tố, giải quyết một phần một yếu tố khác, và không giải quyết hai yếu tố còn lại.

• Tỷ lệ — mất đi theo thiết kế. Đầu ra được căn lại về tâm và chuẩn hóa theo bán kính tối đa bằng một đơn vị. Kích thước tuyệt đối và tọa độ thế giới không được giữ lại, nên mọi mô hình đều phải được chia tỷ lệ lại sang milimét trước khi nó có ý nghĩa gì. Nếu ảnh tham chiếu của bạn đến từ một vật thể thật và bạn cần kích thước thật của nó, Hi3D không mang chúng theo. Repo nói rõ điều này thay vì im lặng, điều đó đáng được ghi nhận, nhưng nghĩa là tỷ lệ là một bước bạn phải tự làm.

• Cấu trúc liên kết — kế thừa từ đầu vào, không được sửa chữa. Hi3D nhận một lưới thô và thêm chi tiết vào đó. Nếu lưới thô đó có các cạnh không đa tạp, tự giao cắt hoặc pháp tuyến bị đảo, quá trình tinh chỉnh chỉ làm chúng trở nên chi tiết hơn chứ không sửa đúng chúng. Phần hạn chế trong chính README nói rằng "cấu trúc thô rất quan trọng" và rằng các lỗi nghiêm trọng của lưới thô có thể vẫn tồn tại. Phần mềm cắt lớp vẫn sẽ gặp lỗi với đúng những khiếm khuyết đó, chỉ là ở độ phân giải cao hơn. Đây là câu quan trọng nhất trong bản phát hành đối với bất kỳ ai định dùng nó để in.

• Bề mặt — không có. Đầu ra là một trimesh.Trimesh chỉ có hình học: không có texture, không có vật liệu, không có màu đỉnh. Đối với in một vật liệu, điều đó hầu như không thành vấn đề, vì bạn in vật liệu chứ không phải bản đồ UV. Đối với bất cứ thứ gì cần kết quả được tô màu hoặc nhiều màu, hoặc bản xem trước cho khách hàng phải trông giống sản phẩm, thì điều đó khiến nó bị loại và đẩy bạn sang v3.0.

• Khả năng in — chưa được đánh giá. Không có gì trong kho mã đo độ dày thành, kích thước đặc trưng tối thiểu, các phần nhô ra, hay liệu lưới có kín nước sau khi tinh chỉnh hay không. Con số cắt lớp 90% nằm trong thông cáo báo chí, không phải trong mã, và không có trình cắt lớp nào được nêu tên. Một tệp đã cắt lớp cũng không phải là một bộ phận đã in: việc cắt lớp thành công không cho bạn biết bản in sẽ bám dính, trụ được với giá đỡ, hay giữ được dung sai.

Những con số, được sắp xếp theo những gì thực sự hậu thuẫn chúng

Bản công bố trộn lẫn những tuyên bố với mức độ hậu thuẫn rất khác nhau. Gộp chúng lại với nhau chính là cách một con số của nhà cung cấp trở thành sự thật trong một quyết định mua hàng.

• Khoảng hai triệu tài sản 3D được tuyển chọn — được nêu trong thông cáo báo chí và trên thẻ mô hình, đồng thời nhất quán với dòng Sparc3D, mà bài báo trước đó mô tả vào khoảng 500.000 tài sản. Bạn không thể kiểm toán việc tuyển chọn từ repo, vì cả bộ dữ liệu lẫn mã huấn luyện đều không được phát hành. Hãy coi đó là một con số đáng tin cậy do nhà cung cấp đưa ra, chứ không phải con số đã được xác minh.

• độ phân giải hiệu dụng 1536³ — thiết lập này là có thật dưới dạng một cấu hình. Pipeline chạy một lượt cho 512³, hai lượt cho 1024³ và ba lượt cho 1536³, với 25 lần cập nhật scheduler mỗi lượt theo mặc định. Từ “effective” rất quan trọng: đây là các lưới tọa độ thưa và lưới trích xuất danh nghĩa, không phải một tensor tiềm ẩn dày đặc 1536³. README cũng lưu ý rằng thiết lập 1536³ mới chỉ được xác thực trên một H20 96 GB và rằng tính khả thi cũng như bộ nhớ đỉnh trên các card nhỏ hơn thì không được nêu.

• 90% thành công khi cắt lát — do nhà cung cấp tự báo cáo, chưa được tái lập và không có phương pháp luận. Không có slicer, không có định nghĩa thất bại, không có mốc cơ sở, không có bộ kiểm thử. Đây là con số dễ trích dẫn nhất trong bản phát hành và cũng khó kiểm chứng nhất.

• Độ trung thực và mức độ chi tiết đa góc nhìn cao nhất — được trình bày như kết quả của "đánh giá đã được báo cáo", vốn không có trong kho lưu trữ. Không có bảng so sánh, không có danh sách đối thủ cạnh tranh và không có phân tích theo từng danh mục.

• "Đã được kiểm chứng trong các quy trình vận hành thực tế" — một câu trên trang thông báo, không có đối tác được nêu tên, không có nghiên cứu điển hình và không có quy trình nào được mô tả. Điều đó hoàn toàn có thể đúng. Nhưng nó chưa phải là bằng chứng.

Bức tường phần cứng

Ngăn xếp đo được là một NVIDIA H20 96 GB, và repo trung thực rằng đây chính là máy mà cấu hình cao nhất đã được xác thực trên đó. Các yêu cầu đi kèm cũng cụ thể không kém: Linux, compute capability 8.0 trở lên, CUDA 12.0 đến 12.5, và hoàn toàn không có đường suy luận trên CPU. flash-attn không có triển khai attention dự phòng, nên lỗi biên dịch ở đó là lỗi nghiêm trọng chứ không phải suy giảm. Batch size bằng một.

Hỗ trợ chuyển tải tuần tự sang CPU và giúp giảm mức chiếm dụng GPU, nhưng README cẩn thận nói rằng nó không thiết lập yêu cầu bộ nhớ GPU tối thiểu và không loại bỏ chi phí của các đặc trưng đã giải mã. Trên thực tế, điều đó có nghĩa là đường xử lý một lượt 512³ có thể vừa trên một card 24 GB, nhưng chưa ai công bố bảng bộ nhớ, và nhà cung cấp chưa tuyên bố điều đó. Nếu kế hoạch của bạn phụ thuộc vào 4090, bạn đang chạy một cấu hình chưa được xác minh và nên tự đo thời gian và đo lường trước khi cam kết.

Một quy trình in đang hoạt động trông như thế nào

Hi3D v1.0 chỉ có một giai đoạn. Kho mã có kèm một bộ chuyển đổi tùy chọn sử dụng Hunyuan3D-2 mini của Tencent để tạo lưới thô từ một ảnh duy nhất; Hunyuan là bên thứ ba và không phải là phụ thuộc của thư viện lõi, nhưng nếu không có thứ tương tự thì bạn không có đầu vào.

Vậy trình tự thực sự là: tạo hoặc lấy một lưới thô, tinh chỉnh nó bằng Hi3D ở 512³, 1024³ hoặc 1536³, xuất hình học, đưa nó về tỉ lệ kích thước thật, sửa mọi lỗi cấu trúc liên kết mà giai đoạn thô đã làm sai, xác minh tính kín nước, rồi cắt lớp. Ba trong số các bước đó — sửa lỗi, xác minh tính kín nước, cắt lớp — không có tương đương ở bất kỳ đâu trong bản phát hành, và bước đầu tiên chính là nơi hầu hết các lỗi sẽ thực sự xảy ra.

OrcaRouter không lưu trữ Hi3D v1.0 hay bất kỳ mô hình 3D nào khác, và sẽ không trả về một mesh có thể in được từ một lệnh gọi API. Thứ nó lưu trữ là phần việc văn bản và thị giác xoay quanh pipeline: viết bản mô tả đối tượng, tạo chú thích cho ảnh tham chiếu, và đánh giá các bản render đa góc nhìn để tìm lỗi trước khi bạn dành thời gian GPU cho một lượt 1536³. Đó là một endpoint cho hơn 200 mô hình với chuyển đổi dự phòng tự động, điều này hữu ích khi các bước kiểm tra xung quanh là phần bạn không muốn tự xây dựng. Bước 3D vẫn nằm trên phần cứng của riêng bạn.

Tuần này ai nên tải nó xuống?

Nếu bạn đã có sẵn một trình tạo lưới thô đang vận hành — Hunyuan3D-2 mini, TripoSR hoặc một công đoạn nội bộ — và nút thắt của bạn là lưới trông mềm, thiếu nét, thì Hi3D v1.0 đáng để bỏ ra một ngày thời gian GPU. Cấu hình 512³ là điểm nên bắt đầu; cấu hình 1536³ cần card lớp H20 mà nhà cung cấp đã dùng.

Nếu yêu cầu của bạn là “một bức ảnh đầu vào, một bộ phận in được đầu ra”, bản phát hành này không làm được điều đó, và phần tiếp thị quanh nó cũng vậy. Bạn vẫn cần giai đoạn đầu tiên, giai đoạn sửa chữa và slicer, và con số 90% không chuyển sang được cho vật thể, vật liệu hay máy in của bạn.

Nếu bạn cần texture, màu sắc hoặc bản render dành cho khách hàng, hãy đợi v3.0 hoặc dùng thứ khác. Chỉ hình học là một ranh giới cứng, không phải khoảng trống tạm thời.

Điều có thể thay đổi kết luận thì hẹp và cụ thể: một slicer được nêu tên, một bộ kiểm thử được công bố, một phân loại lỗi và một baseline — lý tưởng nhất là lưới thô chưa được tinh chỉnh, để người đọc có thể thấy việc tinh chỉnh thực sự mang lại gì. Một bảng bộ nhớ và độ trễ ở cả ba độ phân giải trên nhiều hơn một GPU sẽ giải quyết câu hỏi về phần cứng. Cho đến khi một trong những thứ đó tồn tại, mô tả trung thực về Hi3D v1.0 là một bộ tinh chỉnh hình học mạnh mẽ, thực sự mở, với một tuyên bố sẵn sàng cho sản xuất được gắn vào trước bằng chứng của nó.