Hi3D v1.0 jest open source: czego tak naprawdę wymaga twierdzenie o druku 3D

Hi3D v1.0 pojawił się w serwisach GitHub i Hugging Face 23 października 2026 r. z przypisaną do niego jedną liczbą: 90% skuteczności krojenia. Ta liczba jest całym powodem, dla którego firma zajmująca się drukiem 3D powinna zainteresować się tym wydaniem, a jednocześnie jest to jedyna liczba, której repozytorium nie potrafi odtworzyć. Nie ma w nim slicera, siatek testowych, punktu odniesienia ani definicji tego, co uznaje się za niepowodzenie. To, co faktycznie znajduje się w repozytorium, jest pokaźne: kod inferencji, osiem plików wag oraz pipeline, który przyjmuje zdjęcie referencyjne wraz z zgrubną siatką i zwraca znacznie gęstszą, aż do efektywnej rzadkiej siatki ekstrakcji 1536³. Zatem użyteczne pytanie nie brzmi, czy Hi3D v1.0 działa. Brzmi ono: co musi być spełnione wokół niego, zanim na drugim końcu pojawi się część nadająca się do druku.

Co zostało wydane, dokładnie

Wydanie polega na udostępnieniu kodu źródłowego Sparc3D — pakiet Python i publiczne API nadal noszą nazwy sparc3d i Sparc3DPipeline dla zachowania kompatybilności, a powiązany artykuł naukowy pochodzi z maja 2025 r. Repozytorium GitHub otwarto z sześcioma commitami i jednym tagiem; karta na Hugging Face podaje, że model udostępniono 23 października 2026 r., oraz — w tym samym panelu — że „nie jest wdrażany przez żadnego dostawcę usług inferencji”. Dla v1.0 nie ma hostowanego punktu końcowego. Produkt komercyjny to odrębna, zastrzeżona wersja v3.0 z geometrią 2048³ i teksturami do 8K.

• Co zawiera repozytorium — kod wnioskowania, demo, Docker i ograniczenia zależności oraz dokumentację. Brakuje kodu trenowania, zestawu narzędzi ewaluacyjnych z artykułu, podziałów benchmarków i siatek porównawczych stojących za główną tabelą, a README mówi o tym wprost.

• Co zawierają wagi — osiem plików wymaganych w czasie działania: indeks modelu, konfiguracja schedulera, konfiguracja VAE oraz pliki safetensors, a także dwie konfiguracje transformera i pliki safetensors. Enkodery obrazów, facebook/dinov2-large i openai/clip-vit-large-patch14, są ładowane osobno przy pierwszym użyciu i nie wchodzą w skład katalogu modelu.

• Jak to zainstalować — Python 3.10, PyTorch 2.5.0 z CUDA 12.4, flash-attn==2.7.4.post1, spconv-cu120==2.3.6, instalowane ze źródeł. Nie ma pakietu wheel w PyPI ani gotowego wydania.

• Jaka licencja obowiązuje — Hi3D Open License Agreement 1.0. Nie jest to licencja OSI. Użytkowanie komercyjne jest dozwolone, ale produkt lub usługa, która przekroczy 200 000 miesięcznych aktywnych użytkowników lub 1 000 000 USD miesięcznego przychodu, musi powiadomić Hi3D i w ciągu 60 dni wystąpić o odrębną licencję pisemną, a integracje muszą wyświetlać „Powered by Hi3D 1.0” z linkiem, jeśli dane medium na to pozwala.

Narracja w materiałach o premierze przedstawia to jako model image-to-3D „przemysłowej klasy produkcyjnej”. Strona ogłoszenia samego dostawcy rzeczywiście twierdzi, że został „zweryfikowany w rzeczywistych procesach produkcyjnych” oraz że ocena obejmowała wygląd z wielu widoków, szczegóły lokalne i użyteczność geometryczną. Nie wskazuje jednak ani jednego klienta, procesu ani zmierzonego wyniku. To twierdzenie o produkcji, a nie dowód na nią.

Zastrzeżenie dotyczące drukowania, podzielone na cztery wymagania

Element, który schodzi z drukarki, musi spełniać cztery warunki, które nie mają nic wspólnego z tym, jak imponująco wygląda render. Hi3D v1.0 dobrze radzi sobie z jednym z nich, częściowo z jednym, a z dwoma wcale.

• Skala — znika z założenia. Dane wyjściowe są ponownie wyśrodkowane i znormalizowane do jednostkowego maksymalnego promienia. Bezwzględny rozmiar i współrzędne świata nie są zachowywane, więc każdy model trzeba przeskalować do milimetrów, zanim będzie miał jakiekolwiek znaczenie. Jeśli zdjęcie referencyjne pochodziło z rzeczywistego obiektu i potrzebne były jego rzeczywiste wymiary, Hi3D ich nie przenosi. Repozytorium mówi o tym wprost, zamiast milczeć, co warto docenić, ale oznacza to, że skalowanie to krok należący do Ciebie.

• Topologia — odziedziczona z danych wejściowych, nie naprawiona. Hi3D bierze zgrubną siatkę i dodaje do niej szczegóły. Jeśli ta zgrubna siatka ma krawędzie niebędące rozmaitością, samoprzecięcia lub odwrócone normalne, proces udoskonalania czyni je drobniejszymi, a nie poprawnymi. Sekcja ograniczeń w README mówi: „struktura zgrubna ma znaczenie” oraz że poważne błędy zgrubnej siatki mogą pozostać. Slicer nadal będzie się dławić na tych samych defektach, tylko w wyższej rozdzielczości. To najważniejsze zdanie w tym wydaniu dla każdego, kto kieruje to na drukarkę.

• Powierzchnia — brak. Dane wyjściowe to trimesh.Trimesh zawierający wyłącznie geometrię: bez tekstur, bez materiałów, bez kolorów wierzchołków. W przypadku druku z jednego materiału w większości nie stanowi to problemu, ponieważ drukuje się materiał, a nie mapy UV. Wszędzie tam, gdzie potrzebny jest pomalowany lub wielokolorowy wynik albo podgląd dla klienta, który musi wyglądać jak produkt, jest to dyskwalifikujące i skłania do przejścia na v3.0.

• Drukowalność — brak oceny. W repozytorium nic nie mierzy grubości ścian, minimalnego rozmiaru cechy, nawisów ani tego, czy siatka jest szczelna po rafinacji. Liczba 90% dotycząca cięcia na warstwy widnieje w komunikacie prasowym, a nie w kodzie, i żaden slicer nie został wskazany. Pocięty plik to również nie wydrukowana część: powodzenie cięcia na warstwy nie mówi, że wydruk będzie się trzymał, przetrwa podpory ani utrzyma tolerancję.

Liczby uporządkowane według tego, co faktycznie za nimi stoi

Komunikat łączy twierdzenia o bardzo różnym poziomie udokumentowania. Wrzucanie ich do jednego worka sprawia, że liczba podana przez dostawcę staje się faktem w decyzji zakupowej.

• Około dwóch milionów wyselekcjonowanych aktywów 3D — podano w komunikacie prasowym i na karcie modelu, co jest spójne z linią Sparc3D, którą wcześniejszy artykuł opisywał jako około 500 000 aktywów. Nie można zweryfikować procesu selekcji na podstawie repozytorium, ponieważ nie udostępniono ani zbioru danych, ani kodu treningowego. Należy traktować to jako wiarygodną wartość podaną przez dostawcę, a nie zweryfikowaną.

• efektywna rozdzielczość 1536³ — ta konfiguracja jest realna. Potok wykonuje jeden przebieg dla 512³, dwa dla 1024³ i trzy dla 1536³, domyślnie przy 25 aktualizacjach harmonogramu na przebieg. Słowo „efektywna” ma znaczenie: to nominalne rzadkie siatki współrzędnych i ekstrakcji, a nie gęsty tensor utajony 1536³. README zauważa również, że ustawienie 1536³ zostało zweryfikowane tylko na karcie H20 z 96 GB oraz że wykonalność i szczytowe zużycie pamięci na mniejszych kartach nie zostały określone.

• 90% skuteczności slicowania — zgłoszone przez dostawcę, nieodtworzone i bez opisanej metodyki. Brak slicera, brak definicji niepowodzenia, brak punktu odniesienia, brak zestawu testowego. To najbardziej cytowalna liczba w wydaniu i najtrudniejsza do sprawdzenia.

• Najwyższa wierność i bogactwo szczegółów w trybie wielu widoków — przedstawione jako wynik „raportowanej oceny”, której nie ma w repozytorium. Nie ma tabeli porównawczej, listy konkurentów ani podziału na kategorie.

• "Zweryfikowane w rzeczywistych produkcyjnych przepływach pracy" — zdanie na stronie ogłoszenia, bez wymienionego partnera, bez studium przypadku i bez opisanego przepływu pracy. Może być prawdziwe. To jeszcze nie dowód.

Ściana sprzętowa

Zmierzone środowisko to NVIDIA H20 o pojemności 96 GB, a repozytorium uczciwie przyznaje, że to na tej maszynie walidowano najwyższe ustawienie. Otaczające wymagania są równie konkretne: Linux, compute capability 8.0 lub nowsza, CUDA od 12.0 do 12.5 oraz całkowity brak ścieżki wnioskowania na CPU. flash-attn nie ma zapasowej implementacji uwagi, więc błąd kompilacji w tym miejscu jest krytyczny, a nie powoduje jedynie degradacji. Rozmiar partii wynosi jeden.

Obsługa sekwencyjnego odciążania CPU jest dostępna i zmniejsza rezydencję w GPU, ale README wyraźnie zaznacza, że nie ustala minimalnego wymagania dotyczącego pamięci GPU i nie usuwa kosztu zdekodowanych cech. W praktyce oznacza to, że ścieżka jednoprzebiegowa 512³ może się zmieścić na karcie 24 GB, ale nikt nie opublikował tabeli pamięci, a producent tego nie twierdzi. Jeśli Twój plan opiera się na 4090, używasz niezweryfikowanej konfiguracji i przed podjęciem decyzji powinieneś sam zmierzyć czas i zużycie.

Jak wygląda działający potok drukowania

Hi3D v1.0 to jeden etap. Repozytorium zawiera opcjonalny adapter, który wykorzystuje Tencent Hunyuan3D-2 mini do utworzenia zgrubnej siatki z pojedynczego obrazu; Hunyuan jest rozwiązaniem zewnętrznym i nie jest zależnością biblioteki podstawowej, ale bez czegoś takiego nie masz danych wejściowych.

Zatem rzeczywista kolejność jest następująca: wygeneruj lub uzyskaj zgrubną siatkę, dopracuj ją za pomocą Hi3D przy 512³, 1024³ lub 1536³, wyeksportuj geometrię, przeskaluj ją do rzeczywistych wymiarów, napraw wszystko, co etap zgrubny zepsuł w topologii, zweryfikuj szczelność, a następnie pokrój. Trzy z tych kroków — naprawa, szczelność, cięcie — nie mają odpowiednika nigdzie w wydaniu, a pierwszy z nich to miejsce, w którym faktycznie wystąpi większość awarii.

OrcaRouter nie hostuje Hi3D v1.0 ani żadnego innego modelu 3D i nie zwróci drukowalnej siatki w wyniku wywołania API. Hostuje natomiast prace tekstowe i wizualne wokół potoku przetwarzania: pisanie opisu obiektu, opisywanie zdjęcia referencyjnego i ocenianie renderów z wielu widoków pod kątem defektów, zanim poświęcisz czas GPU na przebieg 1536³. To jest jeden punkt końcowy dla ponad 200 modeli z automatycznym przełączaniem awaryjnym, co jest przydatne, gdy otaczające kontrole to część, której nie chcesz budować samodzielnie. Krok 3D pozostaje na Twoim własnym sprzęcie.

Kto powinien pobrać to w tym tygodniu?

Jeśli masz już w produkcji generator siatek zgrubnych — Hunyuan3D-2 mini, TripoSR lub własny etap — a Twoim wąskim gardłem jest to, że siatki wyglądają na rozmyte, Hi3D v1.0 jest wart jednego dnia czasu GPU. Ścieżka 512³ to miejsce, od którego warto zacząć; ścieżka 1536³ wymaga karty klasy H20, której używał dostawca.

Jeśli Twoim wymaganiem jest „jedno zdjęcie na wejściu, gotowa do druku część na wyjściu”, to wydanie tego nie robi — podobnie jak otaczający je marketing. Nadal potrzebujesz pierwszego etapu, etapu naprawy i slicera, a liczba 90% nie przenosi się na Twoje obiekty, Twój materiał ani Twoją drukarkę.

Jeśli potrzebujesz tekstur, koloru lub renderu dla klienta, poczekaj na v3.0 albo użyj czegoś innego. Wyłącznie geometria to twarda granica, a nie tymczasowa luka.

To, co zmieniłoby werdykt, jest wąskie i konkretne: nazwany slicer, opublikowany zestaw testowy, taksonomia błędów i punkt odniesienia — najlepiej niezrefinowana siatka zgrubna, aby czytelnik mógł zobaczyć, co faktycznie dało refinowanie. Tabela zużycia pamięci i opóźnień dla wszystkich trzech rozdzielczości na więcej niż jednym GPU rozstrzygnęłaby kwestię sprzętową. Dopóki nie istnieje którakolwiek z tych rzeczy, uczciwy opis Hi3D v1.0 to solidny, autentycznie otwarty refiner geometrii z doczepionym twierdzeniem o gotowości produkcyjnej, które wyprzedza dowody.