Napraw drukowalność API

Identyfikator zakończonego powodzeniem zadania, którego jesteś właścicielem. Obsługiwane typy zadań: Obraz na 3D, Wiele obrazów na 3D, Tekst na 3D, Remesh, Reteksturowanie oraz Analizuj drukowalność. Zadanie musi mieć status SUCCEEDED i musi wygenerować zasób GLB.

Zadanie analizy, które sprawdzało grubość ścianki, przekazuje również swoją drukarkę i rozmiar, więc naprawa sprawdza grubość ścianki i pogrubia cienkie ścianki, nawet jeśli nie wyślesz żadnego z tych parametrów; wysłany przez Ciebie printer_type lub rozmiar wydruku nadpisuje tę wartość. Zadania analizy utworzone na podstawie model_url w formacie .stl, .fbx lub .gltf nie są akceptowane: zamiast tego wyślij plik jako model_url.

Adres URL modelu 3D do naprawy. Obsługiwane formaty: .glb, .gltf, .obj, .fbx, .stl. Użyj adresu URL http lub https, albo zakodowanego w base64 adresu URL data: dla GLB (data:model/gltf-binary;base64,...) lub glTF (data:model/gltf+json;base64,...). Pliki .obj, .fbx i .stl muszą zostać wysłane jako adres URL http lub https.

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

Plik GLB, glTF, FBX lub OBJ o rozmiarze powyżej 100 MB może mieć co najwyżej 10 000 000 ścianek. Ścianki liczone są 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 lub glTF nie może używać kompresji Draco.

Adresy URL pobierania Meshy (assets.meshy.ai/…?Expires=…&Signature=…) są podpisane i przestają działać po upływie expires_at zadania; ponowne pobranie zadania ich nie odnawia. W przypadku modelu wygenerowanego za pomocą Meshy przekaż zamiast tego input_task_id. Działa to tak długo, jak przechowywane jest zadanie źródłowe (zobacz Przechowywanie zasobów). Aby ponownie użyć modelu po tym czasie, pobierz go przed expires_at i wyślij własną kopię.

Gdy ustawione na true, zadanie dodatkowo renderuje wersję podglądu z przezroczystym tłem (RGBA) i zwraca ją jako alpha_thumbnail_url w odpowiedzi GET. Istniejące pole thumbnail_url pozostaje bez zmian.

Drukarka, której planujesz użyć. Określa ona minimalną grubość ścianki, do jakiej dąży naprawa. Domyślnie fdm, gdy wysyłasz rozmiar wydruku bez tego parametru, chyba że zadanie analizy przekazane jako input_task_id dostarcza informację o drukarce.

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.

Wysokość wydruku w milimetrach. Zakres: [1, 1000]. Zaokrąglane do najbliższego milimetra. Tylko dla wejścia GLB.

Długość najdłuższej krawędzi wydruku w milimetrach. Zakres: [1, 1000]. Zaokrąglane do najbliższego milimetra. Działa z każdym formatem wejściowym.

Żądanie było niepoprawne. Typowe przyczyny:

• Brak parametru: nie podano ani input_task_id, ani model_url.
• Nieprawidłowy UUID: input_task_id nie jest prawidłowym identyfikatorem UUID.
• Nieprawidłowy adres URL modelu: model_url jest nieprawidłowo sformatowany, używa nieobsługiwanego schematu lub ma nieobsługiwane rozszerzenie pliku.
• Plik modelu zbyt duży: treść model_url przekroczyła 400 MB (adres URL http lub https) lub 100 MB (identyfikator URI data:).
• Zbyt wiele ścianek: model_url to plik GLB, glTF, FBX lub OBJ o rozmiarze powyżej 100 MB z ponad 10 000 000 ścianek. Zmniejsz liczbę ścianek i wyślij plik ponownie.
• ASCII FBX powyżej 100 MB: model_url to plik ASCII FBX o rozmiarze powyżej 100 MB. Wyślij go jako binarny FBX lub GLB.
• Nieodczytywalny plik modelu: model_url ma rozmiar powyżej 100 MB, a jego nagłówek nie może zostać odczytany, na przykład skompresowany Draco plik GLB lub glTF, albo binarny FBX starszy niż 7.1.
• Nagłówek modelu zbyt złożony: model_url ma rozmiar powyżej 100 MB, a jego nagłówek zawiera zbyt wiele siatek, węzłów lub rekordów do sprawdzenia. Zmniejsz liczbę obiektów w pliku i wyślij go ponownie.
• Nie udało się pobrać pliku modelu: model_url zwrócił błąd, najczęściej dlatego, że podpisany adres URL pobierania Meshy wygasł. Ponowne pobranie zadania zwraca ten sam adres URL z tym samym terminem ważności, więc wyślij własną kopię pliku lub użyj input_task_id, dopóki zadanie źródłowe jest nadal przechowywane.
• Zadanie niezakończone powodzeniem: wskazane zadanie jest nadal oczekujące, w trakcie przetwarzania lub zakończyło się niepowodzeniem.
• Brak GLB: wskazane zadanie nie ma zasobu GLB do naprawy.
• Nieprawidłowy rozmiar wydruku: intended_print_height_mm lub intended_print_longest_side_mm znajduje się poza zakresem [1, 1000] lub wysłano oba parametry.
• Nieznany typ drukarki: printer_type nie jest wartością fdm, sla ani full_color.
• Wysokość dla modelu innego niż GLB: intended_print_height_mm zostało wysłane z model_url, który nie jest plikiem .glb. Zamiast tego użyj intended_print_longest_side_mm.
• Nie można określić rozmiaru tego modelu na podstawie wysokości: przy żądanej wysokości (lub domyślnej 150 mm) najdłuższa krawędź modelu wykraczałaby poza zakres [1, 1000] mm, model jest płaski lub jego rozmiar nie może zostać ustalony. Zamiast tego użyj intended_print_longest_side_mm. Dla model_url w formacie .glb oraz niektórych zadań input_task_id jest to ustalane dopiero po rozpoczęciu zadania, a zadanie kończy się wtedy statusem FAILED.
• Nieużyteczny rozmiar STL: wysłano printer_type bez rozmiaru, a własna najdłuższa krawędź pliku .stl nie może zostać odczytana lub znajduje się poza zakresem [1, 1000] mm. Wyślij intended_print_longest_side_mm.

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

Typowe przyczyny:

• Darmowy plan: tworzenie zadań wymaga płatnego planu. Przejdź na wyższy plan na stronie subskrypcji.
• Niewystarczające kredyty: osiągnięto limit kredytów obszaru roboczego.

Wskazane zadanie nie istnieje lub należy do innego użytkownika.

Przekroczono limit oczekujących zadań lub limit szybkości.

ID zadania naprawy drukowalności do pobrania.

ID zadania naprawy drukowalności do usunięcia.

Numer strony do stronicowania. Zaczyna się od 1 i domyślnie ma wartość 1.

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

Pole, według którego sortowane są wyniki. Dostępne wartości:

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

Unikalny identyfikator zadania Napraw drukowalność do strumieniowania.

Unikalny identyfikator zadania. Mimo że jako szczegół implementacyjny używamy identyfikatorów zadań w formacie k-sortable UUID, nie należy zakładać niczego co do formatu identyfikatora.

Typ zadania napraw drukowalność. Wartość to print-repair.

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

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

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 wynosić 0.

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

Znacznik czasu, kiedy wynik zadania wygaśnie w systemie, w milisekundach. 0, jeśli zadanie jeszcze się nie zakończyło.

Informacje o błędzie, jeśli zadanie zakończyło się niepowodzeniem. Ta właściwość ma wartość null, jeśli zadanie nie zakończyło się niepowodzeniem. Zobacz Błędy, aby uzyskać więcej informacji.

Adresy URL do pobrania naprawionego modelu 3D. Wypełnione jest tylko pole odpowiadające formatowi wejściowemu; pozostałe pola formatów są pustymi ciągami znaków.

Adres URL podglądu obrazu wyrenderowanego z naprawionego modelu.

Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecne tylko wtedy, gdy zadanie zostało utworzone z alpha_thumbnail: true, a przezroczysty podgląd został pomyślnie wyrenderowany; w przeciwnym razie to pole jest pomijane.

Zawsze pusta tablica. Naprawa zachowuje wyłącznie geometrię wejściową i nie generuje ponownie tekstur.

Liczba kredytów zużytych przez to zadanie. 10, gdy zadanie osiągnęło status SUCCEEDED. Zwraca 0 dla zadań FAILED (kredyty są zwracane w przypadku niepowodzenia).

Drukarka i rozmiar użyte przez naprawę, niezależnie od tego, czy zostały przesłane, czy ponownie wykorzystane z zadania analizy. Obecne w naprawie grubości ścianki od samego początku (PENDING); wartości jeszcze nieznane mają wartość null.

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