API Druku Wielokolorowego

ID zakończonego powodzeniem zadania, które ma zostać użyte jako dane wejściowe. Obsługiwane typy zadań: Obraz na 3D, Wiele obrazów na 3D, Tekst na 3D, Remesh oraz Reteksturowanie. Zadanie musi mieć status SUCCEEDED.

Publicznie dostępny URL modelu .glb lub .fbx, albo zakodowany w base64 URL data: modelu GLB (data:model/gltf-binary;base64,...). Plik .fbx musi zostać przesłany jako URL http lub https.

Maksymalny rozmiar pliku: 400 MB dla URL http lub https, 100 MB dla URI data:.

Plik większy niż 100 MB może mieć maksymalnie 8 000 000 ścianek. Ścianki są liczone jako trójkąty: czworokąt liczy się jako 2, a siatka narysowana więcej niż raz liczy się raz na każdą kopię. Powyżej 100 MB plik FBX musi być binarnym FBX w wersji 7.1 lub nowszej, a plik GLB nie może używać kompresji Draco.

Maksymalna liczba kolorów w wynikowej palecie.

Prawidłowy zakres: od 1 do 16.

Wizualny styl kolorów wygenerowanego pliku 3MF.

Dostępne wartości:

• realistic: Pobiera kolory bezpośrednio z tekstury modelu, uzyskując drobne, fotorealistyczne szczegóły. Powoduje większy rozmiar pliku.
• cartoon: Spłaszcza kolory do czystych, jednolitych obszarów, uzyskując stylizowany wygląd. Powoduje mniejszy rozmiar pliku.

Dane wejściowe muszą zawierać kolor: realistic wymaga pojedynczej bazowej tekstury koloru ze współrzędnymi UV na każdej części siatki; cartoon akceptuje również kolory przypisane do wierzchołków. Modele bez tekstury (białe) są odrzucane — zobacz model_missing_texture.

Głębokość podziału używana do mapowania kolorów tekstury na siatkę. Wyższe wartości pozwalają uchwycić drobniejsze szczegóły koloru kosztem większego rozmiaru pliku. Dotyczy tylko stylu realistic; ignorowane dla cartoon.

Prawidłowy zakres: od 3 do 6.

Marka drukarki, której preset slicera jest zapisywany w pliku 3MF, dzięki czemu plik otwiera się w slicerze tej marki z odpowiednim profilem drukarki, filamentu i procesu. Każda marka używa swojej domyślnej drukarki z dyszą 0,4 mm.

Dostępne wartości: bambu, anycubic, creality, elegoo, flashforge, prusa, qidi, snapmaker, ankermake.

Żądanie było niepoprawne. Najczęstsze przyczyny:

• Brakujący parametr: Musi zostać podany model_url lub input_task_id.
• Nieprawidłowy format modelu: model_url wskazuje na plik o nieobsługiwanym rozszerzeniu (obsługiwane są tylko .glb i .fbx).
• Niedostępny URL: Nie udało się pobrać pliku spod model_url.
• Plik modelu zbyt duży: Plik pod model_url przekracza 400 MB (URL http lub https) lub 100 MB (URI data:).
• Zbyt wiele ścianek: Plik pod model_url ma ponad 100 MB i więcej niż 8 000 000 ścianek. Zmniejsz liczbę ścianek, a następnie wyślij plik ponownie.
• ASCII FBX powyżej 100 MB: Plik pod model_url to ASCII FBX powyżej 100 MB. Wyślij go jako binarny FBX lub GLB.
• Nieodczytywalny plik modelu: Plik pod model_url ma ponad 100 MB, a jego nagłówka nie można odczytać, na przykład GLB skompresowany Draco lub binarny FBX starszy niż 7.1.
• Nagłówek modelu zbyt złożony: Plik pod model_url ma ponad 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 musi odnosić się do zadania zakończonego powodzeniem.
• Nieprawidłowe max_colors: Wartość musi mieścić się w zakresie od 1 do 16.
• Nieprawidłowy style: Wartość musi mieć wartość realistic lub cartoon.
• Nieprawidłowe max_depth: Wartość musi mieścić się w zakresie od 3 do 6.
• Nieprawidłowy printer_brand: Wartość musi być jedną z marek wymienionych powyżej.
• Brak źródła koloru: Model wejściowy nie ma bazowej tekstury koloru (realistic wymaga pojedynczej, ze współrzędnymi UV, na każdej części siatki) ani kolorów wierzchołków (cartoon akceptuje jedno z nich). Najpierw nałóż teksturę na model lub użyj cartoon dla modeli z kolorami wierzchołków. Pliki .fbx są sprawdzane po tym, jak zadanie je znormalizuje, i kończą się niepowodzeniem z błędem model_missing_texture.

Uwierzytelnianie nie powiodło się. Sprawdź swój klucz API.

Niewystarczająca liczba kredytów do wykonania tego zadania.

Przekroczono limit szybkości.

ID zadania druku 3D do pobrania.

ID zadania druku 3D w wielu kolorach, które ma zostać usunięte.

Numer strony do stronicowania. Zaczyna się i domyślnie wynosi 1.

Limit rozmiaru strony. Domyślnie 10 elementów. Maksymalna dozwolona wartość to 100 elementów.

Pole, według którego ma nastąpić sortowanie. Dostępne wartości:

• +created_at: Sortuj według czasu utworzenia rosnąco.
• -created_at: Sortuj według czasu utworzenia malejąco.

Unikalny identyfikator zadania druku 3D w wielu kolorach, które ma być przesyłane strumieniowo.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy identyfikatorów zadań w formacie k-sortowalnego UUID, nie należy przyjmować żadnych założeń co do formatu identyfikatora.

Typ zadania druku 3D. Wartość to print-multi-color.

Adres URL umożliwiający pobranie pliku modelu 3D wygenerowanego przez Meshy. Właściwość dla danego formatu zostanie pominięta, jeśli dany format nie został wygenerowany, zamiast zwracać pusty ciąg znaków.

Postęp zadania. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie miała wartość 0. Gdy zadanie zakończy się powodzeniem, przyjmie wartość 100.

Status zadania. Możliwe wartości to jedna z: PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Liczba poprzedzających zadań.

Znacznik czasu utworzenia zadania, w milisekundach.

Znacznik czasu rozpoczęcia zadania, w milisekundach. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie miała wartość 0.

Znacznik czasu zakończenia zadania, w milisekundach. Jeśli zadanie jeszcze się nie zakończyło, ta właściwość będzie miała wartość 0.

Szczegóły błędu dla nieudanych zadań. Pełny opis obiektu task_error znajduje się w sekcji Błędy.

Liczba kredytów zużytych przez to zadanie. Obecna, gdy status zadania to PENDING, IN_PROGRESS lub SUCCEEDED. Zwraca 0 dla zadań o statusie FAILED (kredyty są zwracane w przypadku niepowodzenia).