API figurki winylowej Creative Lab

Zdjęcie, które ma zostać przekształcone w wielkogłową figurkę winylową, podane jako publiczny adres URL lub Data URI (data:image/jpeg;base64,<twoje zakodowane w base64 dane obrazu>).

Obraz musi być plikiem JPG, JPEG, PNG lub WebP o rozmiarze maksymalnie 20 MB.

Nazwa zadania, maksymalnie 100 znaków. Jest zwracana w polu name zadania. Dłuższa nazwa zwraca 400.

Określa, czy usunąć tło z obrazu prototypu. true zwraca przezroczysty obraz PNG w formacie RGBA, dzięki czemu możesz umieścić postać na dowolnym tle. Budowanie również zaczyna się od obrazu bez tła. Jeśli Meshy nie może usunąć tła, zwraca obraz z tłem, a zadanie nadal kończy się powodzeniem.

Żądanie nie może zostać wykonane. Na przykład:

• Brakuje image_url.
• Obraz nie jest plikiem JPG, JPEG, PNG ani WebP.
• Obraz jest zbyt mały, przekracza 20 MB lub przekracza maksymalną liczbę pikseli.
• Meshy nie może pobrać obrazu, na przykład ponieważ adres URL zwraca 404 lub upłynął limit czasu.
• Data URI nie jest poprawnym kodowaniem base64.
• Obraz został oznaczony jako NSFW.

Komunikat o błędzie wskazuje, jaki problem został wykryty. Napraw żądanie i wyślij je ponownie.

Brakuje klucza API lub jest on nieprawidłowy. Sprawdź nagłówek Authorization.

Zachodzi jedna z poniższych sytuacji:

• Konto nie ma wystarczającej liczby kredytów.
• Klucz API, obszar roboczy lub członek zespołu osiągnął swój limit kredytów.
• Konto korzysta z planu darmowego.

Sprawdź swoje kredyty i plan, a następnie spróbuj ponownie.

Twój zespół ma włączoną funkcję IP Filtering, a Meshy oznaczyło obraz jako naruszający prawa własności intelektualnej osób trzecich. Prześlij obraz, do którego masz prawa użytkowania.

Osiągnięto jeden z poniższych limitów:

• Wysłano więcej żądań niż pozwala na to limit szybkości. Odczekaj kilka sekund, a następnie spróbuj ponownie. Zobacz Limity szybkości.
• Zbyt wiele zadań jest w kolejce lub trwa ich wykonywanie. Poczekaj, aż niektóre się zakończą, a następnie spróbuj ponownie.
• W planie nielimitowanym bez pozostałych kredytów osiągnięto maksymalną liczbę zadań, które mogą działać bez kredytów. Poczekaj na zakończenie zadania lub dodaj kredyty.

Wystąpił błąd serwera Meshy, na przykład dlatego, że nie udało się przeprowadzić kontroli własności intelektualnej obrazu. Meshy nie tworzy zadania i zwraca wszelkie pobrane kredyty. Spróbuj wysłać żądanie ponownie.

ID zadania prototypu, które ma zostać zbudowane. Musi to być zadanie utworzone przez Twoje konto za pomocą POST /openapi/creative-lab/vinyl-figure/v1/prototype, ze statusem SUCCEEDED.

ID, które nie odpowiada żadnemu z Twoich zadań prototypu Vinyl Figure utworzonych przez API, zwraca 404, w tym prototyp utworzony w aplikacji webowej.

Nazwa zadania, maksymalnie 100 znaków. Jest zwracana w polu name zadania. Dłuższa nazwa zwraca 400.

Żądanie nie może zostać wykonane. Na przykład:

• input_task_id jest nieobecne lub nie jest prawidłowym ID zadania.
• Status zadania prototypu nie jest SUCCEEDED. Jeśli wciąż trwa, poczekaj i spróbuj ponownie. Jeśli zakończyło się niepowodzeniem lub zostało anulowane, utwórz nowe zadanie prototypu.
• Zadanie prototypu zakończyło się powodzeniem, ale nie zawiera obrazu. Utwórz nowe zadanie prototypu.

Komunikat błędu wskazuje, który problem został wykryty.

Klucz API jest nieobecny lub nieprawidłowy. Sprawdź nagłówek Authorization.

Zastosowanie ma jedno z poniższych:

• Konto nie ma wystarczającej liczby kredytów.
• Klucz API, obszar roboczy lub użytkownik osiągnął limit kredytów.
• Konto korzysta z planu darmowego.

Sprawdź swoje kredyty i plan, a następnie spróbuj ponownie.

input_task_id nie odpowiada żadnemu zadaniu prototypu Vinyl Figure utworzonemu przez Twoje konto za pomocą API. Prototyp utworzony w aplikacji webowej również zwraca 404. Wyślij ID result z odpowiedzi tworzenia prototypu.

Osiągnięto jeden z poniższych limitów:

• Wysłano więcej żądań, niż pozwala na to limit szybkości. Poczekaj kilka sekund, a następnie spróbuj ponownie. Zobacz Limity szybkości.
• Zbyt wiele Twoich zadań znajduje się w kolejce lub jest w trakcie wykonywania. Poczekaj, aż część z nich się zakończy, a następnie spróbuj ponownie.
• W przypadku planu nieograniczonego bez pozostałych kredytów osiągnięto liczbę zadań, które mogą być uruchomione bez kredytów. Poczekaj na zakończenie zadania lub dodaj kredyty.

ID zadania z odpowiedzi na żądanie utworzenia.

id nie jest prawidłowym ID zadania. Wyślij ID result z odpowiedzi na żądanie utworzenia.

Twój zespół ma włączone filtrowanie IP, a Meshy oznaczyło obraz zadania jako naruszający własność intelektualną osób trzecich. Zespoły korzystające z planu Enterprise nie otrzymują tego błędu. Utwórz zadanie prototypu na podstawie obrazu, do którego masz prawa.

Żadne zadanie Vinyl Figure o tym ID nie należy do Twojego konta lub etap zadania nie odpowiada ścieżce. Sprawdź ID oraz użyj /prototype lub /build, aby dopasować zadanie.

Meshy nie mogło przeprowadzić kontroli własności intelektualnej. Ponów żądanie.

ID zadania do anulowania.

Zastosowanie ma jedno z poniższych:

• id nie jest prawidłowym ID zadania. Wyślij ID result z odpowiedzi tworzącej zadanie.
• Zadanie ma już status końcowy (SUCCEEDED, FAILED lub CANCELED), więc nie można go anulować.

Żadne zadanie Vinyl Figure o tym ID nie należy do Twojego konta lub etap zadania nie odpowiada ścieżce. Sprawdź ID i użyj /prototype lub /build, aby dopasować zadanie.

ID zadania z odpowiedzi tworzenia.

Etap do wyświetlenia, prototype lub build.

Strona do zwrócenia, od 1 do 255. 0 zwraca pierwszą stronę. Wartość spoza zakresu 0 do 255 zwraca 400.

Liczba zadań na stronę, maksymalnie 100. Wartość od 101 do 255 zwraca 100 zadań, a 0 używa wartości domyślnej. Wartość spoza zakresu 0 do 255 zwraca 400.

Kolejność sortowania.

Dostępne wartości:

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

ID zadania. Nie polegaj na jego formacie.

Typ zadania, zawsze creative-lab-vinyl-figure-prototype.

name, które wysłałeś podczas tworzenia zadania, lub "", jeśli go nie wysłałeś.

Status zadania.

Dostępne wartości:

• PENDING: oczekuje w kolejce
• IN_PROGRESS: generowanie wyniku
• SUCCEEDED: zakończone, z wynikiem
• FAILED: zakończone, z powodem w task_error
• CANCELED: zakończone, bez wyniku

Procent wykonanej pracy, od 0 do 100. Wynosi 0 do momentu rozpoczęcia zadania i 100, gdy się powiedzie.

Czas utworzenia zadania, w milisekundach Unix.

Czas, w którym worker rozpoczął zadanie, w milisekundach Unix. null do tego momentu.

Czas, w którym zadanie osiągnęło status końcowy, w milisekundach Unix. null do tego momentu.

Czas wygaśnięcia wyniku zadania, w milisekundach Unix. Jest to 3 dni po finished_at, lub 3 dni po created_at, dopóki zadanie się nie zakończy. W przypadku kont Enterprise, które przechowują wyniki API bezterminowo, jest to około 100 lat później. Zobacz Przechowywanie zasobów.

Pozycja zadania w kolejce, gdy ma status PENDING. 1 oznacza, że zacznie się jako następne. 0 po opuszczeniu kolejki przez zadanie, i zawsze 0 w wynikach listowania.

Powód niepowodzenia zadania. null, chyba że status to FAILED. Zobacz Błędy.

Liczba kredytów naliczonych za zadanie, po uwzględnieniu ewentualnego zwrotu. Żądanie, które zwraca błąd, nie jest obciążane. Nieudane zadanie ma wartość 0, ponieważ Meshy zwraca za nie środki. Anulowanie zwraca środki za zadanie tylko wtedy, gdy ma ono status PENDING. Jeśli Meshy nie może odczytać opłaty, odpowiedź get lub stream pomija to pole, a żądanie listowania zwraca 500. W takim przypadku ponów żądanie.

Adresy URL do pobrania obrazu koncepcyjnego. Tablica zawiera jeden adres URL po pomyślnym zakończeniu zadania, a wcześniej jest pusta.

ID zadania. Nie polegaj na jego formacie.

Typ zadania, zawsze creative-lab-vinyl-figure-build.

Wartość name wysłana podczas tworzenia zadania, lub "", jeśli jej nie wysłano.

Status zadania.

Dostępne wartości:

• PENDING: oczekuje w kolejce
• IN_PROGRESS: generowanie wyniku
• SUCCEEDED: zakończone, z wynikiem
• FAILED: zakończone, z powodem w task_error
• CANCELED: zakończone, bez wyniku

Procent wykonanej pracy, od 0 do 100. Wynosi 0 do momentu rozpoczęcia zadania i 100, gdy zakończy się sukcesem.

Czas utworzenia zadania, w milisekundach Unix.

Czas rozpoczęcia zadania przez pracownika, w milisekundach Unix. null do tego momentu.

Czas osiągnięcia przez zadanie statusu końcowego, w milisekundach Unix. null do tego momentu.

Czas wygaśnięcia wyniku zadania, w milisekundach Unix. To 3 dni po finished_at lub 3 dni po created_at, dopóki zadanie się nie zakończy. W przypadku kont Enterprise, które przechowują wyniki API bezterminowo, jest to około 100 lat później. Zobacz Przechowywanie zasobów.

Pozycja zadania w kolejce, gdy ma status PENDING. 1 oznacza, że zacznie się jako następne. 0 po opuszczeniu kolejki przez zadanie i zawsze 0 w wynikach list.

Powód niepowodzenia zadania. null, chyba że status to FAILED. Zobacz Błędy.

Liczba kredytów naliczonych za zadanie, po uwzględnieniu ewentualnego zwrotu. Żądanie, które zwraca błąd, nie jest obciążane. Nieudane zadanie ma wartość 0, ponieważ Meshy zwraca za nie kredyty. Anulowanie zwraca kredyty za zadanie tylko wtedy, gdy ma ono status PENDING. Jeśli Meshy nie może odczytać opłaty, odpowiedź typu get lub stream pomija to pole, a żądanie listy zwraca 500. W takim przypadku ponów żądanie.

Zawsze "" dla zadania budowy figurki winylowej.

Zawsze "" dla zadania budowy figurki winylowej, podobnie jak prompt.

Zawsze "" dla zadania budowy figurki winylowej, podobnie jak prompt.

Zawsze "" dla zadania budowy figurki winylowej, podobnie jak prompt.

Adresy URL do pobrania modelu 3D, jako teksturowany plik GLB oraz jako plik OBJ wraz z plikiem MTL.

Adres URL do pobrania podglądu modelu.

Mapy tekstur, jako tablica zawierająca jeden obiekt z mapą koloru bazowego.