Creative Lab Figurka API

Zdjęcie, które ma zostać przekształcone w figurkę chibi, podane jako publiczny adres URL lub Data URI (data:image/jpeg;base64,<your base64-encoded image data>).

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 błąd 400.

Określa, czy usunąć tło z obrazu prototypu. true zwraca przezroczysty plik PNG RGBA, dzięki czemu możesz umieścić obiekt na dowolnym tle. Budowanie również rozpoczyna się od obrazu bez tła. Jeśli Meshy nie może usunąć tła, zwraca obraz z tłem, a zadanie mimo to 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 dlatego, że adres URL zwraca 404 lub przekracza limit czasu.
• Data URI nie jest prawidłowym ciągiem base64.
• Obraz został oznaczony jako NSFW.

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

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

Zastosowanie ma 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 darmowego planu.

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

Twój zespół ma włączone filtrowanie IP, a Meshy oznaczyło obraz jako naruszający własność intelektualną osób trzecich. Wyś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 Twój limit szybkości. Odczekaj kilka sekund, a następnie spróbuj ponownie. Zobacz Limity szybkości.
• Zbyt wiele Twoich zadań oczekuje w kolejce lub jest w trakcie wykonywania. Poczekaj, aż część z nich się zakończy, a następnie spróbuj ponownie.
• W przypadku planu bez limitu zadań, ale bez pozostałych kredytów, osiągnięto liczbę zadań, które mogą zostać uruchomione bez kredytów. Poczekaj na zakończenie zadania lub doładuj kredyty.

Meshy napotkało błąd serwera, na przykład dlatego, że nie mogło 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/figure/v1/prototype, ze statusem SUCCEEDED.

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

Nazwa zadania, maksymalnie 100 znaków. Zostaje zwrócona w polu name zadania. Dłuższa nazwa zwraca 400.

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

• input_task_id jest brakujący lub nie jest prawidłowym ID zadania.
• Status zadania prototypu nie jest SUCCEEDED. Jeśli wciąż trwa, odczekaj 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ę sukcesem, ale nie ma obrazu. Utwórz nowe zadanie prototypu.

Komunikat o błędzie wskazuje, jaki problem wystąpił.

Brak klucza API lub jest on 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 członek osiągnął swój limit kredytów.
• Konto korzysta z darmowego planu.

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

input_task_id nie odpowiada żadnemu zadaniu prototypu figurki 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. Odczekaj kilka sekund, a następnie spróbuj ponownie. Zobacz Limity szybkości.
• Zbyt wiele Twoich zadań znajduje się w kolejce lub jest uruchomionych. Poczekaj, aż niektóre się zakończą, 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, aż zadanie się zakończy, lub dodaj kredyty.

ID zadania ze odpowiedzi utworzenia.

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

Twój zespół ma włączone IP Filtering, a Meshy oznaczyło obraz zadania jako naruszający prawa własności intelektualnej osób trzecich. Zespoły w planie Enterprise nie otrzymują tego błędu. Utwórz zadanie prototypu z obrazu, do którego masz prawa.

Żadne zadanie 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.

Meshy nie mogło przeprowadzić kontroli własności intelektualnej. Spróbuj ponownie.

Identyfikator zadania do anulowania.

Zastosowanie ma jedna z poniższych sytuacji:

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

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

ID zadania z odpowiedzi na żądanie utworzenia.

Etap do wylistowania, prototype lub build.

Strona do zwrócenia, od 1 do 255. Wartość 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-figure-prototype.

name, który 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 przyczyną w task_error
• CANCELED: zakończone, bez wyniku

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

Czas utworzenia zadania, w milisekundach Unix.

Czas, w którym pracownik rozpoczął zadanie, w milisekundach Unix. Do tego czasu null.

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

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, to około 100 lat później. Zobacz Przechowywanie zasobów.

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

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 powoduje zwrot kredytów tylko wtedy, gdy zadanie ma 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.

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

Identyfikator zadania. Nie polegaj na jego formacie.

Typ zadania, zawsze creative-lab-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ę powodzeniem.

Czas utworzenia zadania, w milisekundach Unix.

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

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

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 zostanie uruchomione jako następne. 0 po opuszczeniu kolejki przez zadanie i zawsze 0 w wynikach listy.

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 powoduje zwrot kredytów za zadanie tylko wtedy, gdy ma ono status PENDING. Jeśli Meshy nie może odczytać naliczonej 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 Figure.

Zawsze "" dla zadania budowy Figure, podobnie jak prompt.

Zawsze "" dla zadania budowy Figure, podobnie jak prompt.

Zawsze "" dla zadania budowy Figure, 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 obrazu podglądu modelu.

Mapy tekstur, jako tablica z jednym obiektem zawierającym mapę koloru bazowego.

Czy Meshy usunęło z tekstury koloru bazowego podświetlenia i cienie.