Retexture API

ID ukończonego zadania Obraz na 3D lub Tekst na 3D, które chcesz poddać reteksturowaniu. To zadanie musi być jednym z następujących: Tekst na 3D Preview, Tekst na 3D Refine, Obraz na 3D lub Remesh. Ponadto musi mieć status SUCCEEDED.

Podaj model 3D, który Meshy ma poddać teksturowaniu. Obsługiwane formaty: .glb, .gltf, .obj, .fbx, .stl.

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

Plik GLB, glTF, FBX lub OBJ przekraczający 100 MB może mieć maksymalnie 10 000 000 ścianek. Ścianki liczone są jako trójkąty: quad 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.

Istnieją dwa sposoby dostarczenia modelu:

• Publicznie dostępny URL: Adres URL dostępny z publicznego internetu.
• Data URI: Zakodowany w base64 Data URI modelu. Użyj typu MIME application/octet-stream. Przykład: data:application/octet-stream;base64,<your base64-encoded model data>.

Opisz tekstem pożądany styl tekstury obiektu. Maksymalnie 800 znaków.

Podaj obraz 2D, który pokieruje procesem teksturowania. Obecnie obsługujemy formaty .jpg, .jpeg, .png i .webp.

Maksymalny rozmiar pliku: 20 MB.

Istnieją dwa sposoby dostarczenia obrazu:

• Publicznie dostępny URL: Adres URL dostępny z publicznego internetu
• Data URI: Zakodowany w base64 Data URI obrazu. Przykład Data URI: data:image/jpeg;base64,<your base64-encoded image data>

Podaj od 1 do 4 obrazów pokazujących ten sam obiekt z różnych widoków, aby pokierować teksturowaniem. Pierwszy obraz to główny (przedni) widok; kolejność pozostałych widoków (lewy, tylny, prawy) nie ma znaczenia.

Każdy element akceptuje te same formaty co image_style_url (publicznie dostępny URL lub zakodowany w base64 Data URI, .jpg/.jpeg/.png/.webp).

Maksymalny rozmiar pliku: 20 MB na obraz.

ID modelu AI używanego do reteksturowania. Dostępne wartości: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Zachowaj istniejący układ UV modelu zamiast generować nowy.

• Jeśli reteksturujesz model wygenerowany przez Meshy (poprzez input_task_id lub model_url wskazujący na wynik Meshy), ustaw to na true, aby ponownie użyć jego zoptymalizowanego układu UV.
• Jeśli reteksturujesz model firm trzecich, który przesłałeś, ustaw true, gdy ma on już dobre UV, które chcesz zachować, lub pozostaw false, aby pozwolić Meshy rozwinąć nowe UV (najlepsze dla modeli bez prawidłowego mapowania UV).

Generuj mapy PBR (metallic, roughness, normal) oprócz podstawowego koloru. Mapa emisji jest również dołączana, gdy ai_model to meshy-6, z wyjątkiem texture_resolution: 8k. meshy-6-lite, meshy-7 i latest nie generują mapy emisji.

Rozdzielczość tekstury podstawowego koloru. Jedna z: 2k (2048×2048), 4k (4096×4096) lub 8k (8192×8192). Wyższe rozdzielczości uchwycą więcej szczegółów powierzchni.

Użyj zamiast tego texture_resolution — odpowiednik texture_resolution: "4k". Gdy ustawione są oba, texture_resolution ma pierwszeństwo.

Usuwa podświetlenia i cienie z tekstury podstawowego koloru, dając czystszy rezultat, który lepiej sprawdza się w niestandardowych ustawieniach oświetlenia.

Określa, które formaty plików 3D mają zostać uwzględnione w wyniku. Generowane i zwracane będą tylko żądane formaty, co może skrócić czas ukończenia zadania. Gdy pominięte, uwzględnione są wszystkie obsługiwane formaty.

Dostępne wartości: glb, obj, fbx, stl, usdz, 3mf

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.

Żądanie było niedopuszczalne. Typowe przyczyny:

• Brakujący parametr: Musi zostać podany model_url lub input_task_id.
• Brakujący styl: Musi zostać podany jeden z: text_style_prompt, image_style_url lub multiview_image_urls.
• Sprzeczne wejścia stylu: multiview_image_urls nie może być łączone z text_style_prompt ani image_style_url.
• Nieobsługiwany model dla wielu widoków: multiview_image_urls wymaga jawnego podania ai_model: "meshy-7".
• Model niedostępny: ai_model: "meshy-7" oraz ai_model: "meshy-6-lite" są wdrażane stopniowo i mogą nie być jeszcze włączone dla Twojego konta.
• Nieprawidłowe zadanie wejściowe: input_task_id musi odnosić się do zakończonego sukcesem zadania z obsługiwanego modelu.
• Nieprawidłowy format modelu: model_url wskazuje na plik o nieobsługiwanym rozszerzeniu.
• Niedostępny URL: Nie udało się pobrać model_url, image_style_url lub elementu multiview_image_urls.
• Plik modelu zbyt duży: Plik model_url przekracza 400 MB (adres URL http lub https) lub 100 MB (data: URI).
• Zbyt wiele ścianek: Plik model_url ma ponad 100 MB i 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 jest plikiem ASCII FBX przekraczającym 100 MB. Wyślij go jako binarny FBX lub GLB.
• Nieczytelny plik modelu: Plik model_url ma ponad 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: 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.
• Obraz zbyt duży: Obraz image_style_url lub element multiview_image_urls przekracza 20 MB.

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

Niewystarczająca liczba kredytów do wykonania tego zadania.

Przekroczono limit szybkości.

Unikalny identyfikator zadania Reteksturowania do pobrania.

ID zadania reteksturowania do usunięcia.

Numer strony do stronicowania.

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

Pole do sortowania.

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 reteksturowania do strumieniowania.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy identyfikatora UUID z możliwością sortowania k-sortable dla identyfikatorów zadań, nie należy przyjmować żadnych założeń dotyczących formatu tego identyfikatora.

Typ zadania Reteksturowania. Wartość to retexture.

Pobieralny URL do pliku modelu 3D z teksturą wygenerowanego przez Meshy.

To jest prompt tekstowy, który został użyty do utworzenia zadania teksturowania.

To jest obraz wejściowy, który został użyty do utworzenia zadania teksturowania.

Pobieralne URL-e do obrazów referencyjnych z wielu widoków, które zostały użyte do utworzenia zadania teksturowania. Występuje tylko wtedy, gdy zadanie zostało utworzone z multiview_image_urls.

Pobieralny URL do miniatury pliku modelu.

Pobieralny URL do wersji z przezroczystym tłem (RGBA) pliku thumbnail_url. Występuje 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.

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

Znacznik czasu rozpoczęcia zadania, w milisekundach. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość wynosi 0.

Znacznik czasu utworzenia zadania, w milisekundach.

Znacznik czasu wygaśnięcia wyniku zadania, w milisekundach.

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

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

Tablica obiektów URL tekstur wygenerowanych przez zadanie. Zwykle zawiera ona tylko jeden obiekt URL tekstury. Każdy URL tekstury posiada następujące właściwości:

Liczba poprzedzających zadań.

Szczegóły błędu dla nieudanych zadań. Pełny opis obiektu task_error znajdziesz w sekcji Błędy.

Liczba kredytów zużytych przez to zadanie. Obecna, gdy status zadania to PENDING, IN_PROGRESS lub SUCCEEDED. Zwraca 0 dla zadań FAILED (kredyty są zwracane w przypadku niepowodzenia).