Creative Lab — API składanego fidgetu

Zdjęcie źródłowe, które Meshy ma przekształcić w składanego fidgeta. Obecnie obsługujemy formaty .jpg, .jpeg, .png i .webp.

Istnieją dwa sposoby dostarczenia obrazu:

• Publicznie dostępny URL: Adres URL dostępny z publicznego internetu.
• Data URI: Zakodowany w base64 identyfikator URI danych obrazu. Przykład Data URI: data:image/jpeg;base64,<twoje zakodowane w base64 dane obrazu>.

Najlepiej sprawdza się obiekt z jednym wyraźnym, zamkniętym konturem — to sylwetka staje się pierścieniami. Zatłoczone tła, kilka osobnych obiektów lub bardzo cienkie kształty mogą pozostawić zbyt mało miejsca na zagnieżdżone ściany, przez co zadanie zakończy się błędem.

Opcjonalna nazwa zadania do celów wyświetlania. Maksymalnie 100 znaków. To wyłącznie etykieta zadania; nic nie jest grawerowane na modelu.

Żądanie było niepoprawne. Częste przyczyny:

• Brakujący parametr: image_url jest wymagany.
• Nieprawidłowy format obrazu: Podany image_url nie ma obsługiwanego formatu (.jpg, .jpeg, .png, .webp).
• Wymiary obrazu poza zakresem: Obraz jest zbyt mały, przekracza maksymalny rozmiar pliku lub przekracza maksymalną liczbę pikseli.
• Niedostępny URL: Nie udało się pobrać image_url (404 lub timeout).
• Nieprawidłowy Data URI: Ciąg base64 jest nieprawidłowo sformatowany.
• Oznaczona treść: Obraz wejściowy został oznaczony przez moderation NSFW.

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

Albo twoje konto działa w ramach darmowego planu — utworzenie zadania w tym punkcie końcowym wymaga płatnego planu — albo masz niewystarczającą liczbę kredytów.

Obraz wejściowy został oznaczony jako naruszenie własności intelektualnej.

Przekroczono limit szybkości.

Unikalny identyfikator zadania składanego fidgeta, które ma zostać pobrane.

Unikalny identyfikator zadania składanego fidgeta do anulowania.

Zadanie znajduje się już w stanie końcowym i nie może zostać anulowane.

Zadanie nie istnieje, należy do innego użytkownika lub nie zostało utworzone za pomocą tego punktu końcowego.

Unikalny identyfikator zadania collapsible fidget do przesyłania strumieniowego.

Numer strony do stronicowania.

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

Pole, według którego ma zostać przeprowadzone sortowanie. Dostępne wartości:

• +created_at: Sortuj według czasu utworzenia rosnąco.
• -created_at: Sortuj według czasu utworzenia malejąco.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy identyfikatorów zadań w formacie k-sortable UUID, nie należy zakładać żadnego konkretnego formatu id.

Typ zadania. Wartość to creative-lab-fidget-collapsible.

Nazwa zadania podana podczas jego tworzenia. Pusty ciąg znaków, jeśli nie podano nazwy.

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

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

Znacznik czasu utworzenia zadania, w milisekundach.

Znacznik czasu rozpoczęcia zadania, w milisekundach. Jeśli zadanie jeszcze się nie rozpoczęło, wartość tej właściwości wynosi null.

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

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

Liczba poprzedzających zadań.

Szczegóły błędu dla nieudanych zadań. Pełny opis obiektu task_error znajduje się 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).

Adresy URL do pobrania wygenerowanego modelu 3D. Wypełniane po zakończeniu zadania statusem SUCCEEDED: stl jest zawsze obecne, glb tylko wtedy, gdy renderowanie podglądu się powiodło.