Retexture API

Wymagane, chyba że wyślesz model_url. ID zadania, które wygenerowało model 3D do teksturowania, na przykład zadania Tekst na 3D, Obraz na 3D, Remesh lub Reteksturowanie. Zadanie musi być utworzone przez Ciebie za pomocą API i mieć status SUCCEEDED. Meshy teksturuje plik GLB tego zadania.

W przypadku meshy-n1 model zadania może mieć co najwyżej 7 999 999 ścianek, liczonych jako trójkąty (czworokąt liczy się jako 2).

Wymagane, chyba że wyślesz input_task_id. Model do teksturowania, 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 co najwyżej 400 MB pochodzącym z URL http lub https, lub 100 MB jako data URI. W przypadku data URI użyj typu MIME application/octet-stream, na przykład data:application/octet-stream;base64,<Twoje dane modelu zakodowane w base64>.

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

• Plik GLB, glTF, FBX lub OBJ może mieć co najwyżej 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 kopię.
• Plik FBX musi być binarnym FBX w wersji 7.1 lub nowszej.
• Plik GLB lub glTF nie może używać kompresji Draco.

W przypadku meshy-n1 model może mieć co najwyżej 7 999 999 ścianek, liczonych jako trójkąty (czworokąt liczy się jako 2), niezależnie od rozmiaru pliku.

Wymagane, chyba że wyślesz image_style_url lub multiview_image_urls. Tekst opisujący pożądaną teksturę, do 800 znaków. Dłuższy tekst zwraca 400. W przypadku meshy-n1 wysłanie go bez image_style_url zwraca 400.

Wymagane, chyba że wyślesz text_style_prompt lub multiview_image_urls. Obraz 2D, którego styl ma naśladować tekstura, jako publiczny URL lub data URI (data:image/jpeg;base64,<Twoje dane obrazu zakodowane w base64>). Jeśli wyślesz zarówno text_style_prompt, jak i image_style_url, Meshy użyje image_style_url.

Obraz musi być plikiem .jpg, .jpeg, .png lub .webp o rozmiarze co najwyżej 20 MB, mającym co najmniej 32 piksele z każdej strony.

Tekstura może nie pasować dobrze, gdy obiekt na obrazie ma kształt bardzo różniący się od modelu. W przypadku meshy-n1 Meshy traktuje obraz jako widok z przodu.

Wymagane, chyba że wyślesz text_style_prompt lub image_style_url. Od jednego do czterech obrazów tego samego obiektu z różnych widoków. Pierwszy obraz to widok główny (z przodu). Kolejność pozostałych widoków (lewy, tylny, prawy) nie ma znaczenia. Pusta tablica lub więcej niż cztery obrazy zwracają 400.

Każdy obraz musi spełniać te same zasady formatu i rozmiaru co image_style_url, maksymalnie 20 MB na obraz. Nie możesz łączyć multiview_image_urls z text_style_prompt ani image_style_url.

multiview_image_urls wymaga jawnego ustawienia ai_model na meshy-7 lub meshy-n1. Jakikolwiek inny ai_model, w tym domyślny latest, zwraca 400.

Model AI generujący teksturę.

Dostępne wartości:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: tekstura koloru bazowego 2K wyłącznie z obrazów referencyjnych. Brak promptu tekstowego, brak map PBR, brak 4K ani 8K. Do 7 999 999 ścianek.
• latest: Meshy 7

Czy zachować układ UV modelu zamiast generować nowy.

• Dla modelu wygenerowanego przez Meshy, z input_task_id lub model_url wskazującego na wynik Meshy, użyj true, aby ponownie wykorzystać jego zoptymalizowany układ UV.
• Dla modelu przesłanego skądinąd, użyj true, aby zachować już dobre UV. Pozostaw false, aby Meshy wygenerowało nowe UV, co sprawdza się dla modelu bez odpowiedniego mapowania UV.

Czy generować również mapy PBR (metaliczność, chropowatość i normalną) wraz z kolorem bazowym. W przypadku meshy-6 Meshy generuje też mapę emisji, z wyjątkiem texture_resolution ustawionego na 8k. meshy-6-lite, meshy-7 i latest nie generują mapy emisji. W przypadku meshy-n1 wartość true zwraca 400.

Rozmiar tekstury koloru bazowego. Wyższe rozdzielczości rejestrują więcej szczegółów powierzchni.

Dostępne wartości:

• 2k: 2048 × 2048 pikseli
• 4k: 4096 × 4096 pikseli
• 8k: 8192 × 8192 pikseli

4k i 8k wymagają ai_model ustawionego na meshy-6, meshy-7 lub latest. W przypadku meshy-6-lite lub meshy-n1 zwracają 400. Przy 8k Meshy nie generuje mapy emisji.

Zamiast tego użyj texture_resolution. true jest równoważne texture_resolution: "4k". Jeśli wyślesz oba, Meshy użyje texture_resolution.

Czy usunąć z tekstury koloru bazowego światła i cienie. Wynik sprawdza się lepiej przy własnym oświetleniu.

Meshy stosuje to tylko z meshy-6, przy texture_resolution ustawionym na 2k lub 4k. W przypadku meshy-7 lub latest, lub przy 8k, Meshy akceptuje ten parametr i go ignoruje. W przypadku meshy-6-lite lub meshy-n1 wysłanie go z jakąkolwiek wartością zwraca 400.

Formaty plików do wygenerowania. Meshy generuje tylko wymienione formaty, co może skrócić zadanie. Jeśli pominiesz ten parametr, Meshy wygeneruje wszystkie formaty oprócz 3mf.

Dostępne wartości:

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

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

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

• Brakujący parametr: Nie wysłano ani model_url, ani input_task_id.
• Brakujący styl: Nie wysłano żadnego z text_style_prompt, image_style_url i multiview_image_urls.
• Sprzeczne wejścia stylu: multiview_image_urls wysłano razem z text_style_prompt lub image_style_url.
• Nieobsługiwany model dla wielu widoków: multiview_image_urls wysłano bez jawnego ustawienia ai_model na meshy-7 lub meshy-n1.
• Nieobsługiwana opcja dla Meshy N1: meshy-n1 wysłano z enable_pbr: true, remove_lighting, texture_resolution ustawionym na 4k lub 8k, hd_texture: true bez texture_resolution, lub text_style_prompt bez image_style_url.
• Zbyt wiele trójkątów dla Meshy N1: W przypadku meshy-n1 model 3D ma więcej niż 7 999 999 trójkątów. Zmniejsz liczbę trójkątów lub użyj innego ai_model.
• Model zbyt złożony dla Meshy N1: W przypadku meshy-n1 plik model_url jest zbyt złożony, aby Meshy mogło policzyć jego trójkąty. Zmniejsz liczbę trójkątów, a następnie wyślij plik ponownie.
• Przekroczono czas liczenia trójkątów: W przypadku meshy-n1 policzenie trójkątów pliku model_url trwało zbyt długo. Spróbuj ponownie lub zmniejsz rozmiar modelu.
• Nieprawidłowe zadanie wejściowe: input_task_id nie jest zakończonym powodzeniem zadaniem obsługiwanego typu.
• Nieprawidłowy format modelu: Plik model_url ma nieobsługiwane rozszerzenie.
• Niedostępny URL: Meshy nie może pobrać pliku model_url, obrazu image_style_url lub obrazu z multiview_image_urls.
• Plik modelu zbyt duży: Plik model_url przekracza 400 MB z URL 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, a następnie wyślij plik ponownie.
• ASCII FBX powyżej 100 MB: Plik model_url to ASCII FBX o rozmiarze powyżej 100 MB. Wyślij go jako binarny FBX lub GLB.
• Nieodczytywalny plik modelu: Plik model_url przekracza 100 MB, a Meshy nie może odczytać jego nagłówka. Na przykład jest to GLB lub glTF skompresowany za pomocą Draco, lub binarny FBX starszy niż 7.1.
• Nagłówek modelu zbyt złożony: Plik model_url przekracza 100 MB, a jego nagłówek ma 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 image_style_url lub obraz z multiview_image_urls przekracza 20 MB.

W przypadku meshy-n1 model, którego Meshy nie może sprawdzić przed rozpoczęciem zadania, taki jak plik STL, nie jest tutaj odrzucany. Jeśli ma więcej niż 7 999 999 trójkątów, zadanie kończy się niepowodzeniem, a Meshy zwraca wykorzystane kredyty.

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

Zastosowanie ma jedno z poniższych:

• Moderacja treści zablokowała prompt lub obraz wejściowy. Zmień dane wejściowe, a następnie spróbuj ponownie.
• input_task_id to model płaskorzeźby, którego ten punkt końcowy nie może reteksturować. 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, a następnie 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ść zwraca 400.

Liczba zadań na stronę, maksymalnie 100.

Kolejność sortowania.

Dostępne wartości:

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

ID zadania z odpowiedzi tworzącej zadanie.

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

Typ zadania, zawsze retexture.

Adresy URL do pobrania teksturowanego modelu 3D, po jednym dla każdego formatu pliku.

Prompt tekstowy, z którym utworzono zadanie.

Obraz stylu, z którym utworzono zadanie.

Adresy URL do pobrania obrazów referencyjnych z wielu widoków, z którymi utworzono zadanie. Obecne tylko wtedy, gdy zadanie utworzono z multiview_image_urls.

Adres URL do pobrania miniatury modelu.

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

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

Czas rozpoczęcia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie rozpocznie.

Czas utworzenia zadania, w milisekundach Unix.

Czas wygaśnięcia wyników zadania, w milisekundach Unix.

Czas zakończenia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie zakończy.

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

Adresy URL do pobrania wygenerowanych tekstur, jako tablica obiektów. Tablica zazwyczaj zawiera jeden obiekt. Każdy obiekt ma następujące pola:

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

Szczegóły błędu, gdy zadanie się nie powiedzie. Zobacz Błędy.

Liczba kredytów zużytych przez zadanie. Obecne, gdy status to PENDING, IN_PROGRESS lub SUCCEEDED. Wynosi 0 dla zadania FAILED, ponieważ Meshy zwraca kredyty, gdy zadanie się nie powiedzie.