API Napraw drukowalność

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

Zadanie Analizuj drukowalność, które sprawdziło grubość ścianki, przekazuje dalej także swoją drukarkę i rozmiar. Naprawa sprawdza wtedy grubość ścianki i pogrubia cienkie ścianki, nawet jeśli nie wyślesz żadnego z tych parametrów. printer_type lub rozmiar druku, który wyślesz, zastępuje te pochodzące z analizy. Zadanie Analizuj drukowalność dla pliku .stl, .fbx lub .gltf z model_url nie działa. Zamiast tego wyślij ten plik jako model_url.

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

Z adresu URL 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 w base64 (data:model/gltf-binary;base64,...) lub glTF (data:model/gltf+json;base64,...) o rozmiarze maksymalnie 100 MB. Plik .obj, .fbx lub .stl wyślij jako adres URL http lub https.

Plik większy niż 100 MB musi także 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 liczy się jako 2, a siatka narysowana więcej niż raz liczy się raz na każdą kopię.
• Plik FBX musi być binarnym plikiem FBX w wersji 7.1 lub nowszej.
• Plik GLB lub glTF nie może używać kompresji Draco.

Adres URL pobierania Meshy (assets.meshy.ai/…?Expires=…&Signature=…) jest podpisany i przestaje działać po expires_at swojego zadania. Ponowne odczytanie zadania nie odnawia go. 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 po tym czasie, pobierz go przed expires_at i wyślij własną kopię.

Czy wyrenderować także podgląd z przezroczystym tłem (RGBA), zwracany w alpha_thumbnail_url przy pobieraniu zadania. thumbnail_url się nie zmienia.

Drukarka, której planujesz użyć. Określa ona minimalną grubość ścianki, do jakiej dąży naprawa. Jeśli wyślesz rozmiar druku bez printer_type, Meshy użyje fdm, chyba że zadanie Analizuj drukowalność w input_task_id dostarczy drukarkę.

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

Dowolna inna wartość zwraca 400.

Wysokość wydruku, w milimetrach, od 1 do 1000. Wartość spoza tego 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 tego zakresu zwraca 400. Działa z każdym formatem danych wejściowych.

Żądanie nie może zostać wykonane. Komunikat błędu wskazuje, jaki problem został wykryty. 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 z adresu URL http lub https, lub ponad 100 MB jako Data URI.
• Zbyt dużo ścianek: Plik model_url to plik GLB, glTF, FBX lub OBJ większy niż 100 MB z ponad 10 000 000 ścianek. Zmniejsz liczbę ścianek, a następnie wyślij plik ponownie.
• ASCII FBX ponad 100 MB: Plik model_url to plik FBX w formacie ASCII większy niż 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 GLB lub glTF skompresowany Draco, lub 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 dlatego, że wygasł podpisany adres URL pobierania 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.
• Brak GLB: Zadanie input_task_id nie ma modelu GLB do naprawy.
• Nieprawidłowy rozmiar druku: intended_print_height_mm lub intended_print_longest_side_mm jest poza zakresem 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 dopasować rozmiaru tego modelu na podstawie wysokości: Przy żądanej wysokości lub domyślnych 150 mm najdłuższy bok modelu wypadł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 oraz 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.

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ź swoje saldo kredytów, a następnie spróbuj ponownie.
• Plan bezpłatny: Utworzenie zadania wymaga płatnego planu. Zaktualizuj swój plan w ustawieniach subskrypcji, a następnie spróbuj ponownie.

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

Zadanie input_task_id nie istnieje lub należy do innego użytkownika. Sprawdź identyfikator i użyj klucza API z konta, które utworzyło to zadanie.

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 na żądanie utworzenia.

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 tworzenia.

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

Typ zadania, zawsze print-repair.

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

Jaka część zadania jest wykonana, w procentach. Wynosi 0 do czasu rozpoczęcia zadania 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 do momentu rozpoczęcia zadania.

Czas zakończenia zadania, w milisekundach Unix. Wynosi 0 do momentu zakończenia zadania.

Czas wygaśnięcia wyniku zadania, w milisekundach Unix. Wynosi 0 do momentu zakończenia zadania.

Szczegóły błędu, gdy zadanie zakończy się niepowodzeniem. Jest null, jeśli zadanie nie zakończyło się niepowodzeniem. Zobacz Błędy.

Adresy URL do pobrania naprawionego modelu. Zawiera tylko klucz odpowiadający formatowi wejściowemu. Format, którego zadanie nie wygenerowało, nie ma klucza, zamiast pustego ciągu znaków.

Adres URL do pobrania obrazu podglądu naprawionego modelu.

Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecny tylko wtedy, gdy zadanie zostało utworzone z alpha_thumbnail: true, a Meshy wyrenderowało przezroczysty podgląd.

Zawsze pusta tablica. Naprawa zachowuje tylko wejściową geometrię i nie przelicza ponownie tekstur.

Liczba kredytów zużytych przez zadanie. Wynosi 10, gdy zadanie ma status SUCCEEDED, oraz 0 dla zadania FAILED, ponieważ Meshy zwraca kredyty, gdy zadanie zakończy się niepowodzeniem.

Drukarka i rozmiar, które zostały użyte podczas naprawy — niezależnie od tego, czy zostały przesłane, czy Meshy ponownie je wykorzystało z zadania Analizuj drukowalność. Obecne w naprawie grubości ścianki od samego początku, nawet gdy zadanie ma status PENDING. Wartość, której Meshy jeszcze nie zna, ma wartość null.

Co zrobiła naprawa grubości ścianki. Obecne po pomyślnym zakończeniu naprawy grubości ścianki.