Analizuj drukowalność API

Wymagane, chyba że wyślesz model_url. ID zadania, którego model chcesz przeanalizować. Zadanie musi mieć status SUCCEEDED i musi być Twoje lub znajdować się w obszarze roboczym, do którego należysz.

Może to być jeden z tych typów zadań, z użyciem Meshy 6 lub nowszego, w tym Meshy 7:

• Obraz na 3D
• Wiele obrazów na 3D
• Tekst na 3D
• Remesh
• Reteksturowanie

Działa również zadanie Napraw drukowalność.

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

Dla adresu http lub https, model musi być plikiem .glb, .gltf, .obj, .fbx lub .stl o rozmiarze maksymalnie 400 MB. Data URI może zawierać tylko plik GLB zakodowany w base64 (data:model/gltf-binary;base64,...) lub glTF (data:model/gltf+json;base64,...) o rozmiarze maksymalnie 100 MB. Plik .obj, .fbx lub .stl należy wysłać jako adres http lub https.

Plik większy niż 100 MB musi dodatkowo spełniać następujące zasady:

• Plik GLB, glTF, FBX lub OBJ może mieć maksymalnie 10 000 000 ścianek. Meshy liczy ścianki jako trójkąty, więc czworokąt liczony jest 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 lub glTF nie może używać kompresji Draco.

URL do pobrania z Meshy (assets.meshy.ai/…?Expires=…&Signature=…) jest podpisany i przestaje działać po expires_at danego zadania. Ponowne odczytanie zadania go nie odnawia. Dla modelu utworzonego w Meshy wyślij zamiast tego input_task_id, który działa, dopóki Meshy przechowuje zadanie źródłowe (zobacz Przechowywanie zasobów). Aby użyć modelu później, pobierz go przed upływem expires_at i wyślij własną kopię.

Drukarka, której planujesz użyć. Ustawia minimalną grubość ścianki dla sprawdzenia grubości ścianki. Jeśli wyślesz rozmiar wydruku bez printer_type, Meshy użyje fdm.

Dostępne wartości:

• fdm: filament, minimalna grubość ścianki 1,0 mm
• sla: żywica, minimalna grubość ścianki 0,8 mm
• full_color: pełny kolor, minimalna grubość ścianki 2,0 mm

Każda inna wartość zwraca 400.

Wysokość wydruku w milimetrach, od 1 do 1000. Wartość spoza zakresu zwraca 400. Wyślij ten parametr lub intended_print_longest_side_mm, nie oba naraz.

Działa tylko z danymi wejściowymi GLB. Dla model_url, który nie jest plikiem .glb, wyślij zamiast tego intended_print_longest_side_mm.

Długość najdłuższego boku wydruku w milimetrach, od 1 do 1000. Wartość spoza zakresu zwraca 400. Działa z każdym formatem wejściowym.

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

• Brakujący parametr: Nie wysłano ani input_task_id, ani model_url.
• Nieprawidłowy UUID: input_task_id nie jest prawidłowym UUID.
• Nieprawidłowy URL modelu: model_url jest nieprawidłowo sformatowany, używa nieobsługiwanego schematu lub ma nieobsługiwane rozszerzenie pliku.
• Plik modelu zbyt duży: Plik model_url ma ponad 400 MB przy adresie http lub https, lub ponad 100 MB jako Data URI.
• Zbyt wiele ścianek: Plik model_url to plik GLB, glTF, FBX lub OBJ o rozmiarze powyżej 100 MB i z więcej niż 10 000 000 ścianek. Zmniejsz liczbę ścianek, a następnie wyślij plik ponownie.
• ASCII FBX powyżej 100 MB: Plik model_url to plik ASCII FBX o rozmiarze powyżej 100 MB. Wyślij go jako binarny FBX lub GLB.
• Nieodczytywalny plik modelu: Plik model_url ma ponad 100 MB, a Meshy nie może odczytać jego nagłówka. Na przykład jest to plik GLB lub glTF skompresowany Draco, albo binarny FBX starszy niż 7.1.
• Nagłówek modelu zbyt złożony: Plik 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.
• Nie można pobrać pliku modelu: model_url zwrócił błąd, najczęściej z powodu wygaśnięcia podpisanego URL do pobierania z Meshy. Ponowne odczytanie zadania zwraca ten sam URL z tym samym terminem wygaśnięcia. Wyślij własną kopię pliku lub wyślij input_task_id, dopóki Meshy przechowuje zadanie źródłowe.
• Zadanie nie zakończyło się sukcesem: Zadanie input_task_id wciąż oczekuje, jest w trakcie przetwarzania lub zakończyło się niepowodzeniem.
• Nieprawidłowy rozmiar wydruku: intended_print_height_mm lub intended_print_longest_side_mm jest poza zakresem od 1 do 1000, lub żądanie zawiera oba parametry.
• Nieznany typ drukarki: printer_type nie jest fdm, sla ani full_color.
• Wysokość dla modelu innego niż GLB: Żądanie zawiera intended_print_height_mm oraz model_url, który nie jest plikiem .glb. Wyślij zamiast tego intended_print_longest_side_mm.
• Nie można ustalić rozmiaru tego modelu na podstawie wysokości: Przy żądanej wysokości lub domyślnej wysokości 150 mm, najdłuższy bok modelu wypadałby poza zakresem od 1 do 1000 mm. Dzieje się tak również, gdy model jest płaski lub gdy Meshy nie może określić jego rozmiaru. Wyślij zamiast tego intended_print_longest_side_mm. Dla model_url w formacie .glb i niektórych zadań input_task_id Meshy wykrywa to dopiero po rozpoczęciu zadania, a zadanie kończy się wtedy ze statusem FAILED.
• Rozmiar STL nieprzydatny: Żądanie zawiera printer_type bez rozmiaru, a Meshy nie może odczytać własnego najdłuższego boku pliku .stl, lub jest on poza zakresem od 1 do 1000 mm. Wyślij intended_print_longest_side_mm.

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

Brakuje klucza API lub jest on nieprawidłowy. Sprawdź nagłówek Authorization.

input_task_id to model bas-relief, którego ten punkt końcowy nie może przeanalizować. Komunikat brzmi This model type does not support this operation. Wyślij inny model.

Meshy nie może znaleźć modelu do analizy dla input_task_id. Na przykład:

• Zadanie nie istnieje, zostało usunięte lub nie jest Twoje ani nie znajduje się w obszarze roboczym, do którego należysz.
• Zadanie używa modelu starszego niż Meshy 6, lub jego typ nie tworzy modelu 3D.
• Plik modelu zadania nie znajduje się już w pamięci.

Sprawdź, czy input_task_id to obsługiwane zadanie, które jest Twoje lub znajduje się w jednym z Twoich obszarów roboczych, albo wyślij model jako model_url.

Przekroczono limit szybkości lub masz zbyt wiele oczekujących zadań. Poczekaj, a następnie spróbuj ponownie. Zobacz Limity szybkości.

ID zadania z odpowiedzi tworzenia.

ID zadania do usunięcia.

Numer strony do zwrócenia, zaczynając od 1.

Liczba zadań na stronę, maksymalnie 100.

Kolejność sortowania.

Dostępne wartości:

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

ID zadania z odpowiedzi utworzenia.

ID zadania. Traktuj je jako nieprzejrzysty ciąg znaków i nie polegaj na jego formacie.

Typ zadania, zawsze print-analyze.

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

Jaka część zadania jest wykonana, w procentach. Wynosi 0, dopóki zadanie się nie rozpocznie, i 100, gdy zakończy się powodzeniem.

Liczba zadań znajdujących się przed tym zadaniem 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. Jest null, jeśli zadanie nie zakończyło się niepowodzeniem. Zobacz Błędy.

Wynik analizy. Nie jest obecny, dopóki zadanie nie ma statusu SUCCEEDED.

Liczba kredytów zużytych przez zadanie. Zawsze wynosi 0, ponieważ analiza jest bezpłatna.