API druku wielokolorowego

Wymagane, chyba że wyślesz model_url. ID zadania, którego model chcesz wydrukować, na przykład zadania Obraz na 3D, Wiele obrazów na 3D, Tekst na 3D, Remesh lub Reteksturowanie. Zadanie musi być utworzone przez Ciebie za pomocą API i mieć status SUCCEEDED.

Druk wielokolorowy odczytuje plik GLB zadania, który może mieć co najwyżej 8 000 000 ścian. Model z większą liczbą ścian zwraca 400. W takim przypadku najpierw uruchom na nim zadanie Remesh i wyślij zamiast tego ID zadania Remesh.

Wymagane, chyba że wyślesz input_task_id. Model do wydrukowania, jako publiczny URL lub Data URI. Jeśli wyślesz oba, Meshy użyje input_task_id.

Adres URL http lub https musi wskazywać na plik .glb lub .fbx o rozmiarze co najwyżej 400 MB. Data URI musi zawierać plik GLB zakodowany w base64 o rozmiarze co najwyżej 100 MB. Użyj data:model/gltf-binary;base64,. Plik .fbx wyślij jako adres URL http lub https.

Plik powyżej 100 MB musi dodatkowo spełniać następujące zasady:

• Może mieć co najwyżej 8 000 000 ścian. Meshy liczy ściany jako trójkąty, więc czworokąt liczy się jako 2, a siatka narysowana więcej niż raz liczy się raz na każdą kopię.
• Plik FBX musi być binarnym FBX w wersji 7.1 lub nowszej.
• Plik GLB nie może używać kompresji Draco.

Maksymalna liczba kolorów w wynikowej palecie, od 1 do 16. Aby użyć wartości domyślnej, pomiń ten parametr zamiast wysyłać 0.

Styl kolorów pliku 3MF.

Dostępne wartości:

• realistic: pobiera kolory bezpośrednio z tekstury modelu, dając drobne, fotorealistyczne detale, i tworzy większy plik.
• cartoon: spłaszcza kolory do czystych, jednolitych obszarów, dając stylizowany wygląd, i tworzy mniejszy plik.

Model musi mieć kolor. realistic wymaga pojedynczej tekstury koloru bazowego, z UV-ami na każdej części siatki, a cartoon akceptuje też kolory wierzchołków. Meshy odrzuca model bez tekstury (biały). Zobacz model_missing_texture.

Głębokość podziału, której Meshy używa do próbkowania kolorów tekstury na siatkę, od 3 do 6. 0 to to samo, co pominięcie parametru. Wyższe wartości wychwytują drobniejsze szczegóły kolorów i tworzą większy plik. Używa go tylko styl realistic, a cartoon go ignoruje.

Marka drukarki, której profil slicera Meshy zapisuje w pliku 3MF. Plik otwiera się następnie w slicerze tej marki z dopasowanym profilem drukarki, filamentu i procesu. Profil używa domyślnej drukarki danej marki, z dyszą 0,4 mm.

Dostępne wartości:

• bambu
• anycubic
• creality
• elegoo
• flashforge
• prusa
• qidi
• snapmaker
• ankermake

Każda inna wartość zwraca 400.

Żądanie nie może zostać wykonane. Komunikat o błędzie wskazuje, jaki problem został wykryty. Na przykład:

• Brak parametru: Nie wysłano ani model_url, ani input_task_id.
• Nieprawidłowy format modelu: Plik model_url nie jest plikiem .glb ani .fbx.
• Niedostępny URL: Meshy nie może pobrać pliku model_url.
• Plik modelu zbyt duży: Plik model_url przekracza 400 MB z adresu URL http lub https, albo przekracza 100 MB jako Data URI.
• Zbyt dużo ścian: Plik model_url ma ponad 100 MB i ponad 8 000 000 ścian. Zmniejsz liczbę ścian, a następnie wyślij plik ponownie.
• ASCII FBX powyżej 100 MB: Plik model_url to ASCII FBX powyżej 100 MB. Wyślij go jako binarny FBX lub GLB.
• Nieczytelny plik modelu: Plik model_url przekracza 100 MB, a Meshy nie może odczytać jego nagłówka. Na przykład jest to GLB skompresowany Draco lub binarny FBX starszy niż 7.1.
• Nagłówek modelu zbyt złożony: Plik model_url przekracza 100 MB, a jego nagłówek zawiera zbyt wiele siatek, węzłów lub rekordów do sprawdzenia. Zmniejsz liczbę obiektów w pliku, a następnie wyślij go ponownie.
• Nieprawidłowe zadanie wejściowe: input_task_id nie jest zakończonym powodzeniem zadaniem.
• Zbyt dużo ścian w zadaniu wejściowym: Model input_task_id ma ponad 8 000 000 ścian. Uruchom na nim zadanie Remesh, a następnie wyślij zamiast tego ID zadania Remesh.
• Nieprawidłowe max_colors: max_colors jest ujemne lub większe niż 16.
• Nieprawidłowy style: style nie jest realistic ani cartoon.
• Nieprawidłowe max_depth: max_depth jest poza zakresem 3 do 6 i nie jest 0.
• Nieprawidłowe printer_brand: printer_brand nie jest jedną z dostępnych wartości.
• Brak źródła koloru: Modelowi brakuje koloru wymaganego przez style. realistic wymaga pojedynczej tekstury koloru bazowego, z UV-ami, na każdej części siatki. cartoon akceptuje teksturę koloru bazowego lub kolory wierzchołków. Najpierw nałóż teksturę na model lub użyj cartoon dla modelu z kolorami wierzchołków. Meshy sprawdza przesłany plik .fbx dopiero po tym, jak zadanie go znormalizuje, więc zadanie kończy się niepowodzeniem z model_missing_texture.

Popraw żądanie, a następnie wyślij je ponownie. Zobacz Błędy.

Brak klucza API lub klucz API jest nieprawidłowy. Sprawdź nagłówek Authorization.

Na przykład:

• Niewystarczające kredyty: Konto nie ma wystarczającej liczby kredytów na to zadanie lub konto osiągnęło limit kredytów. Sprawdź saldo kredytów, a następnie spróbuj ponownie.
• Plan darmowy: Utworzenie zadania wymaga płatnego planu. Uaktualnij swój plan w ustawieniach subskrypcji, a następnie spróbuj ponownie.

input_task_id to model płaskorzeźby, którego ten punkt końcowy nie może wydrukować. Komunikat to This model type does not support this operation. Wyślij inny model.

input_task_id nie pasuje do żadnego z Twoich zadań. Sprawdź ID zadania, a następnie wyślij żądanie ponownie.

Przekroczono limit szybkości. Poczekaj, a następnie spróbuj ponownie. Zobacz Limity szybkości.

ID zadania pochodzące z odpowiedzi tworzenia.

ID zadania do usunięcia.

Numer strony do zwrócenia. Numeracja stron zaczyna się od 1.

Liczba zadań na stronę, maksymalnie 100.

Kolejność sortowania.

Dostępne wartości:

• +created_at: od najstarszych
• -created_at: od najnowszych

Identyfikator zadania z odpowiedzi tworzenia.

Identyfikator zadania. Traktuj go jako nieprzezroczysty ciąg znaków i nie polegaj na jego formacie.

Typ zadania, zawsze print-multi-color.

Adresy URL do pobrania wydrukowanego modelu, po jednym dla każdego formatu pliku. Format, którego zadanie nie wygenerowało, nie posiada klucza, zamiast mieć pusty ciąg znaków.

Informacja o tym, jaka część zadania została ukończona, wyrażona w procentach. Wynosi 0, dopóki zadanie się nie rozpocznie, i 100, gdy zakończy się powodzeniem.

Status zadania, jeden z: PENDING, IN_PROGRESS, SUCCEEDED, FAILED lub CANCELED.

Liczba zadań poprzedzających to zadanie w kolejce. Wartość ma znaczenie tylko wtedy, gdy zadanie ma status PENDING.

Czas utworzenia zadania, w milisekundach Unix.

Czas rozpoczęcia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie rozpocznie.

Czas zakończenia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie zakończy.

Czas wygaśnięcia wyniku zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie zakończy.

Szczegóły błędu, gdy zadanie zakończy się niepowodzeniem. Zobacz Błędy.

Liczba kredytów zużytych przez zadanie. Obecne, gdy status to PENDING, IN_PROGRESS lub SUCCEEDED. Wynosi 0 dla zadania FAILED, ponieważ Meshy zwraca kredyty, gdy zadanie kończy się niepowodzeniem.