Remesh API

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

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

Model musi być plikiem GLB, glTF, OBJ, FBX lub STL o rozmiarze maksymalnie 400 MB, jeśli pochodzi z adresu http lub https, lub 100 MB, jeśli jest przesyłany jako data URI. W przypadku data URI użyj typu MIME application/octet-stream.

Plik przekraczający 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 liczona jest raz na każdą kopię.
• Plik FBX musi być binarnym plikiem FBX 7.1 lub nowszym.
• Plik GLB lub glTF nie może używać kompresji Draco.

Formaty plików do wygenerowania.

Dostępne wartości:

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

Typ ścianek modelu po remeshu.

Dostępne wartości:

• quad: siatka z przewagą czworokątów
• triangle: zdecymowana siatka trójkątna

Docelowa liczba ścianek, od 100 do 300000. Wynik może różnić się od wartości docelowej, w zależności od geometrii modelu. Wartość spoza tego zakresu zwraca 400.

Adaptacyjna liczba ścianek, według poziomu. Gdy ustawisz ten parametr, Meshy ignoruje target_polycount.

Dostępne wartości:

• 1: ultra
• 2: wysoki
• 3: średni
• 4: niski

Zamiast tego użyj Resize API. Wysokość, do której ma zostać przeskalowany model, w metrach. Wyślij co najwyżej jeden z parametrów resize_height, resize_longest_side i auto_size.

Zamiast tego użyj Resize API. Długość, do której ma zostać przeskalowany najdłuższy bok prostopadłościanu ograniczającego modelu, w metrach. Wyślij co najwyżej jeden z parametrów resize_height, resize_longest_side i auto_size.

Zamiast tego użyj Resize API. Czy oszacować rzeczywistą wysokość obiektu za pomocą wizji AI i przeskalować model do niej. Wyślij co najwyżej jeden z parametrów resize_height, resize_longest_side i auto_size.

Zamiast tego użyj Resize API. Gdzie umieścić punkt początkowy modelu, bottom lub center. Wartość domyślna obowiązuje, gdy wyślesz resize_height, resize_longest_side lub auto_size. Bez żadnego z nich Meshy przesuwa punkt początkowy tylko wtedy, gdy wyślesz origin_at.

Zamiast tego użyj Convert API. Czy tylko skonwertować model na target_formats. Gdy true, Meshy ignoruje topology, target_polycount, decimation_mode, resize_height, resize_longest_side i auto_size, ale nadal sprawdza ich wartości, więc nieprawidłowa wartość zwraca 400. Przy convert_format_only: true pusty lub null target_formats zwraca 400.

Czy wygenerować również podgląd z przezroczystym tłem (RGBA), zwracany w alpha_thumbnail_url podczas pobierania zadania. thumbnail_url się nie zmienia.

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

• Brakujący parametr: Nie wysłano ani model_url, ani input_task_id.
• Nieprawidłowe zadanie wejściowe: input_task_id nie jest zakończonym powodzeniem zadaniem API lub jego model AI nie obsługuje remeshu.
• Nieprawidłowy format modelu: Plik model_url ma nieobsługiwane rozszerzenie.
• Nieosiągalny URL: Meshy nie może pobrać pliku model_url.
• Plik modelu zbyt duży: Plik model_url przekracza 400 MB, jeśli pochodzi z adresu http lub https, lub 100 MB jako data URI.
• Zbyt wiele ścianek: Plik model_url przekracza 100 MB i ma więcej niż 10 000 000 ścianek. Zmniejsz liczbę ścianek i wyślij plik ponownie.
• ASCII FBX powyżej 100 MB: Plik model_url to plik ASCII FBX przekraczający 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 plik GLB lub glTF skompresowany Draco, albo binarny plik 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 i wyślij go ponownie.
• Nieprawidłowa topologia: topology nie jest quad ani triangle.
• Wzajemnie wykluczające się parametry: Żądanie zawiera więcej niż jeden z parametrów auto_size, resize_height i resize_longest_side. Wyślij tylko jeden z nich.

Popraw żądanie i 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ź saldo kredytów, a następnie spróbuj ponownie.
• Plan darmowy: Tworzenie zadania wymaga płatnego planu. Uaktualnij swój plan w ustawieniach subskrypcji, a następnie spróbuj ponownie.

input_task_id wskazuje model płaskorzeźby, którego ten punkt końcowy nie może poddać remeshowi. Komunikat brzmi 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 i wyślij żądanie ponownie.

Przekroczono limit szybkości. 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, maksymalnie 255. Większa wartość zwróci 400.

Liczba zadań na stronę, maksymalnie 100.

Kolejność sortowania.

Dostępne wartości:

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

Identyfikator zadania z odpowiedzi tworzącej zadanie.

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

Typ zadania, zawsze remesh.

Adresy URL do pobrania remeshowanego modelu, po jednym dla każdego formatu pliku. Format, którego zadanie nie wygenerowało, nie ma klucza, zamiast pustego ciągu znaków.

Adres URL do pobrania podglądu remeshowanego 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ł przezroczysty podgląd.

Jaka część zadania została ukończona, w procentach. Wynosi 0 do momentu rozpoczęcia zadania 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 do momentu rozpoczęcia zadania.

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

Czas wygaśnięcia adresów URL do pobrania zadania, w milisekundach Unix. Wynosi 0 do momentu zakończenia zadania.

Adresy URL do pobrania map tekstur modelu, gdy zadanie zakończy się powodzeniem: tablica obiektów, po jednym dla każdego zestawu tekstur. Każdy obiekt zawiera adres URL base_color, a także może zawierać adresy URL metallic, roughness, normal, emission i metallic_roughness. Wynosi null do momentu zakończenia zadania powodzeniem i jest pustą tablicą, gdy model nie ma map tekstur.

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

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