Rigging API

Wymagane, chyba że wyślesz model_url. ID zadania, którego model chcesz rigować. Meshy obsługuje teksturowane modele humanoidalne.

Model może mieć maksymalnie 380 000 trójkątów (czworokąt liczy się jako 2), a model z większą liczbą zwraca 400. Aby nie przekroczyć tego limitu, uruchom na nim najpierw Remesh API z target_polycount równym 300000 lub mniej, albo 150000 lub mniej przy topology: quad.

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

Model musi być plikiem GLB (.glb) o rozmiarze maksymalnie 400 MB z adresu URL http lub https, albo 100 MB jako Data URI. Rigging obsługuje teksturowane modele humanoidalne.

Model może mieć maksymalnie 380 000 trójkątów (czworokąt liczy się jako 2), a model z większą liczbą zwraca 400. Aby nie przekroczyć tego limitu, uruchom na nim najpierw Remesh API z target_polycount równym 300000 lub mniej, albo 150000 lub mniej przy topology: quad.

Twarz postaci musi być skierowana w kierunku osi +Z, czyli standardowego kierunku „do przodu” w glTF. Estymacja pozy zawiedzie w przypadku modelu zwróconego w innej osi.

Plik większy niż 100 MB musi dodatkowo spełniać te zasady:

• Może mieć maksymalnie 10 000 000 ścian. Plik z większą liczbą zwraca 400. Meshy liczy ściany jako trójkąty, a siatka narysowana więcej niż raz liczy się raz na każdą kopię.
• Nie może używać kompresji Draco.

Przybliżona wysokość postaci w metrach. Meshy wykorzystuje tę wartość, aby dokładniej przeskalować i rigować model. Wartość ujemna zwraca 400.

Pomiń ten parametr, jeśli model ma własne tekstury. Bez niego Meshy użyje tekstur osadzonych w pliku model_url lub tekstur zadania wejściowego. Jeśli go wyślesz, ten obraz stanie się jedyną teksturą rigowanego modelu, a model utraci swoje mapy PBR.

Rozwinięta w UV tekstura koloru bazowego modelu, jako publiczny URL lub Data URI. Obraz musi być plikiem PNG o rozmiarze maksymalnie 20 MB. Inny format obrazu zwraca 400.

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

• Brakujący parametr: Nie wysłano ani model_url, ani input_task_id.
• Nieprawidłowy format modelu: Plik model_url ma nieobsługiwane rozszerzenie. Obsługiwane jest wyłącznie .glb.
• Nieosiągalny URL: Meshy nie może pobrać pliku model_url.
• Plik modelu zbyt duży: Plik model_url przekracza 400 MB z adresu URL http lub https, albo przekracza 100 MB jako Data URI.
• Zbyt wiele ścian: Plik model_url przekracza 100 MB i ma więcej niż 10 000 000 ścian. Zmniejsz liczbę ścian, a następnie wyślij plik ponownie.
• Nieodczytywalny plik modelu: Plik model_url przekracza 100 MB, a Meshy nie może odczytać jego nagłówka. Na przykład jest to plik GLB skompresowany Draco.
• 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, a następnie wyślij go ponownie.
• Obraz zbyt duży: Obraz texture_image_url przekracza 20 MB.
• Nieprawidłowy format tekstury: Obraz texture_image_url nie jest plikiem PNG.
• Nieprawidłowa wysokość: height_meters jest ujemne.
• Nieprawidłowe zadanie wejściowe: input_task_id nie odnosi się do prawidłowego zadania API.
• Zadanie wejściowe nie jest gotowe: Zadanie input_task_id nie osiągnęło statusu SUCCEEDED. Poczekaj, aż się powiedzie, a następnie spróbuj ponownie.
• Przekroczona liczba ścian: Model wejściowy ma więcej niż 380 000 trójkątów (czworokąt liczy się jako 2). Uruchom na nim Remesh API z target_polycount równym 300000 lub mniej, albo 150000 lub mniej przy topology: quad, zanim zrigujesz model.

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

Brak 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: Utworzenie zadania wymaga płatnego planu. Uaktualnij 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 zrigować. Komunikat brzmi This model type does not support this operation. Wyślij inny model.

Meshy nie może znaleźć plików zadania input_task_id. Zastosowanie ma jedno z poniższych:

• Meshy usunęło pliki zadania po upływie jego expires_at. Utwórz zadanie ponownie, a następnie wyślij ID tego zadania.
• Zadanie nie ma żadnego z plików potrzebnych do riggingu, np. obrazu podglądu, na przykład zadanie Convert. Zrigguj zadanie, z którego ten model pochodzi, albo wyślij model jako model_url.

Estymacja pozy nie powiodła się. Model może nie być prawidłową postacią humanoidalną. Wyślij model postaci humanoidalnej. W przypadku model_url sprawdź też, czy postać jest zwrócona w kierunku osi +Z.

Przekroczono limit szybkości. Poczekaj, a następnie spróbuj ponownie. Zobacz Limity szybkości.

ID zadania z odpowiedzi tworzącej zadanie.

ID zadania do usunięcia.

ID zadania z odpowiedzi na żądanie utworzenia.

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

Typ zadania, zawsze rig.

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

Jaka część zadania została ukończona, wyrażona w procentach. Wynosi 0, dopóki zadanie się nie rozpocznie, i 100, gdy zakończy się powodzeniem.

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 plików wynikowych zadania, w milisekundach Unix. Po tym czasie Meshy może usunąć te pliki.

Szczegóły błędu, gdy zadanie zakończy się niepowodzeniem. Jest null, chyba że status to FAILED. Zobacz Błędy.

Liczba kredytów zużytych przez zadanie. Obecne, gdy status to PENDING, IN_PROGRESS lub SUCCEEDED. Dla zadania FAILED wynosi 0, ponieważ Meshy zwraca kredyty, gdy zadanie kończy się niepowodzeniem.

Adresy URL plików wyjściowych. Dopóki zadanie nie zakończy się powodzeniem, każdy adres URL jest pustym ciągiem znaków, a basic_animations ma wartość null.

Liczba zadań znajdujących się przed tym zadaniem w kolejce. Wartość ta ma znaczenie tylko wtedy, gdy zadanie ma status PENDING. Pole jest pomijane, gdy wartość wynosi 0.