Creative Lab Collapsible Fidget API

Zdjęcie, które ma zostać zamienione w collapsible fidget, podane jako publicznie dostępny URL lub Data URI (data:image/jpeg;base64,<zakodowane w base64 dane obrazu>).

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

Sylwetka obiektu staje się pierścieniami, dlatego najlepiej sprawdza się obiekt z jednym wyraźnym, zamkniętym konturem. Zbyt rozbudowane tło, kilka oddzielnych obiektów lub bardzo cienkie kształty mogą pozostawić zbyt mało miejsca na zagnieżdżone ścianki. W takim przypadku zadanie kończy się niepowodzeniem.

Nazwa zadania, maksymalnie 100 znaków. Jest zwracana w polu name zadania, a Meshy nie grawiruje jej na modelu. Dłuższa nazwa zwraca 400.

Żą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ż URL zwraca 404 lub upłynął limit czasu.
• Data URI nie zawiera prawidłowego kodu base64.
• Obraz został oznaczony jako NSFW.

Komunikat błędu wskazuje, jaki problem wykryto. 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 IP Filtering, a Meshy oznaczyło obraz jako naruszający prawa własności intelektualnej osób trzecich. Wyślij obraz, do którego masz prawa.

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ń oczekuje w kolejce lub jest w trakcie wykonywania. Poczekaj, aż niektóre się zakończą, a następnie spróbuj ponownie.
• Przy planie bez limitu, ale bez pozostałych kredytów, osiągnięto liczbę zadań, które mogą działać bez kredytów. Poczekaj, aż zadanie się zakończy, lub dodaj kredyty.

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

ID zadania z odpowiedzi tworzącej zadanie.

id nie jest prawidłowym ID zadania. Wyślij ID result z odpowiedzi tworzącej zadanie.

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

Żadne zadanie Collapsible Fidget o tym ID nie należy do Twojego konta lub zadanie nie zostało utworzone za pomocą tego punktu końcowego. Sprawdź ID.

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

ID zadania do anulowania.

Zachodzi jeden z poniższych przypadków:

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

Żadne zadanie Collapsible Fidget o tym ID nie należy do Twojego konta lub zadanie nie zostało utworzone za pomocą tego punktu końcowego. Sprawdź ID.

ID zadania z odpowiedzi utworzenia.

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

Liczba zadań na stronę, do 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: najpierw najnowsze
• +created_at: najpierw najstarsze

ID zadania. Nie polegaj na jego formacie.

Typ zadania, zawsze creative-lab-fidget-collapsible.

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 czasu rozpoczęcia zadania i 100, gdy zakończy się powodzeniem.

Czas utworzenia zadania, w milisekundach Unix.

Czas, w którym worker 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. Przypada 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 rozpocznie się jako następne. 0 po opuszczeniu kolejki przez zadanie, oraz zawsze 0 w wynikach list.

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

Liczba kredytów pobranych za zadanie, po uwzględnieniu ewentualnego zwrotu. Żądanie, które zwraca błąd, nie jest obciążane opłatą. 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.

Adresy URL do pobrania modelu 3D, puste do momentu powodzenia zadania. Zadanie zakończone sukcesem zawsze ma stl, a glb ma tylko wtedy, gdy Meshy wyrenderowało podgląd.