Creative Lab — API lampy

Tekstowy prompt opisujący pożądany motyw abażuru. Wymagany, gdy pominięto image_url. Maksymalnie 800 znaków.

Zdjęcie źródłowe, którego Meshy używa jako wizualnego odniesienia dla abażuru. Wymagane, gdy pominięto text. Obecnie obsługujemy formaty .jpg, .jpeg, .png i .webp.

Obraz można podać na dwa sposoby:

• Publicznie dostępny URL: 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>.

Wskazówka kategorii tematu dla ścieżki image-to-3D. Dostępne wartości:

• character (domyślne) — pojedyncza postać / obiekt (figurina, zwierzę, maskotka itp.).
• landscape — plenerowa scena / panorama (góra, panorama miasta, las itp.).

Ignorowane na ścieżce text-to-3D.

Opcjonalna nazwa zadania do celów wyświetlania. Maksymalnie 100 znaków.

Żądanie było nieakceptowalne. Typowe przyczyny:

• Brakujący parametr: Wymagane jest dokładnie jedno z text lub image_url.
• Podano oba: Przekazanie zarówno text, jak i image_url jest odrzucane — wzajemnie się wykluczają.
• Nieprawidłowy format obrazu: Podany image_url nie jest w obsługiwanym formacie (.jpg, .jpeg, .png, .webp).
• Wymiary obrazu poza zakresem: Obraz jest zbyt mały, przekracza maksymalny rozmiar pliku albo przekracza maksymalną liczbę pikseli.
• Nieosiągalny URL: Nie udało się pobrać image_url (404 lub timeout).
• Nieprawidłowy Data URI: Ciąg base64 jest zniekształcony.
• Treść oznaczona: Obraz wejściowy został oznaczony przez NSFW lub moderation własności intelektualnej.
• Tekst zbyt długi: text przekracza 800 znaków.
• Nieprawidłowy image_subject: Nie jest jednym z character / landscape.

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

Niewystarczające kredyty do wykonania tego zadania.

Przekroczono Twój limit szybkości.

ID zadania prototypu utworzonego za pomocą tego samego punktu końcowego OpenAPI. Prototyp musi być utworzony przy użyciu tego samego klucza API, musi osiągnąć SUCCEEDED i musi wygenerować dokładnie jeden obraz kandydujący.

Zadania prototypu utworzone przez aplikację webową nie są akceptowane — punkt końcowy budowania akceptuje tylko zadania prototypu utworzone przez POST /openapi/creative-lab/lamp/v1/prototype i odrzuca każde inne źródło z 404.

Opcjonalna nazwa zadania do celów wyświetlania. Maksymalnie 100 znaków.

Docelowy maksymalny wymiar prostopadłościanu ograniczającego klosza lampy, w milimetrach. Siatka jest skalowana równomiernie, aby się zmieścić. Zakres: [50, 400].

Grubość ścianki pustego klosza lampy, w milimetrach. Zakres: (0, 10].

Procent wysokości klosza lampy do spłaszczenia u góry, aby wydruk mógł leżeć na stole. Zakres: [1, 100].

Preset mocowania źródła światła, który określa, czy (i jaki) dysk podstawy wygenerować wraz z kloszem lampy. Dostępne wartości:

• bambu_mh001_60mm (domyślnie) — generuje dysk podstawy 60 mm o rozmiarze dla kompatybilnego mocowania źródła światła. Wynik zawiera model_urls.base_stl.
• none — brak mocowania, brak dysku podstawy. model_urls.base_stl jest pomijane.

Poziome przesunięcie osi X wycięcia mocowania względem środka klosza lampy, w milimetrach. Ma znaczenie tylko wtedy, gdy light_source_preset ≠ none. Zakres: [-80, 80].

Pionowe przesunięcie osi Z wycięcia mocowania względem dołu klosza lampy, w milimetrach. Zakres: [-80, 80].

Obrót wokół osi X zastosowany do zaimportowanej siatki przed przetwarzaniem, w stopniach. Zakres: [-360, 360].

Obrót wokół osi Y zastosowany do zaimportowanej siatki przed przetwarzaniem, w stopniach. Zakres: [-360, 360].

Obrót wokół osi Z zastosowany do zaimportowanej siatki przed przetwarzaniem, w stopniach. Zakres: [-360, 360].

Gdy true i output.format to zip, dołącza result.json procesora lampy (zawierający zmierzone metryki siatki + rozwiązany zestaw opcji) do pakietu. Ignorowane, gdy output.format to stl.

Pakiet artefaktów zwracany przez budowanie. Dostępne wartości:

• stl (domyślnie) — zwraca klosz lampy jako model_urls.lamp_stl, plus model_urls.base_stl, gdy light_source_preset ≠ none.
• zip — pakuje każdy artefakt generowany przez procesor (lamp.stl, opcjonalny base.stl, opcjonalny result.json) do jednego pliku zip i zwraca go w model_urls.bundle_zip.

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

• Brakujący parametr: input_task_id jest wymagane.
• Nieprawidłowy UUID: input_task_id nie jest prawidłowym UUID.
• Zadanie nadrzędne nie zakończyło się powodzeniem: Odwołane zadanie prototypu nie osiągnęło jeszcze SUCCEEDED.
• Brak kandydata: Zadanie prototypu zakończyło się powodzeniem, ale nie wygenerowało obrazu kandydującego.
• Opcje poza zakresem: Jedno z pól options znalazło się poza dozwolonym zakresem lub zestawem enum.

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

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

Odwołane zadanie prototypu nie istnieje, należy do innego użytkownika lub zostało utworzone przez aplikację webową (tylko zadania prototypu w mode API można łączyć z budowaniem).

Przekroczono limit szybkości.

Unikalny identyfikator zadania lampy do pobrania.

Unikalny identyfikator zadania lampy do anulowania.

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

Zadanie nie istnieje, należy do innego użytkownika albo jego etap nie pasuje do ścieżki URL.

Unikalny identyfikator zadania lampy do strumieniowania.

Albo prototype, albo build. Kolekcja zwraca tylko zadania, których etap odpowiada adresowi URL — pobranie /prototype nigdy nie zwraca zadań budowania i odwrotnie.

Numer strony dla stronicowania.

Limit rozmiaru strony. Maksymalna dozwolona liczba to 50 elementów.

Pole, według którego należy sortować. Dostępne wartości:

• +created_at: Sortuj według czasu utworzenia w kolejności rosnącej.
• -created_at: Sortuj według czasu utworzenia w kolejności malejącej.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy identyfikatora UUID sortowalnego typu k dla identyfikatorów zadań, nie należy przyjmować żadnych założeń dotyczących formatu id.

Typ zadania. Wartość to creative-lab-lamp-prototype.

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

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

progress zadania. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie mieć wartość 0. Gdy zadanie zakończy się powodzeniem, wartość ta stanie się 100.

Znacznik czasu utworzenia zadania, w milisekundach.

Znacznik czasu rozpoczęcia zadania, w milisekundach. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie mieć wartość 0.

Znacznik czasu zakończenia zadania, w milisekundach. Jeśli zadanie nie zostało jeszcze zakończone, ta właściwość będzie mieć wartość 0.

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

Liczba poprzedzających zadań.

Szczegóły błędu dla zadań zakończonych niepowodzeniem. Zobacz Błędy, aby uzyskać pełną referencję obiektu task_error.

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

Adresy URL do pobrania dla kandydatów obrazów koncepcyjnych wygenerowanych przez to zadanie prototypu. Obecnie API zawsze zwraca dokładnie jednego kandydata; pole jest tablicą, aby przyszłe wersje mogły udostępniać wielu kandydatów bez zmiany łamiącej kompatybilność.

Unikalny identyfikator zadania.

Typ zadania. Wartość to creative-lab-lamp-build.

Nazwa zadania podana podczas tworzenia zadania. 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.

Progress zadania. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie mieć wartość 0. Po pomyślnym ukończeniu zadania wartość ta stanie się 100.

Znacznik czasu utworzenia zadania, w milisekundach.

Znacznik czasu rozpoczęcia zadania, w milisekundach.

Znacznik czasu zakończenia zadania, w milisekundach.

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

Liczba poprzedzających zadań. Ma znaczenie tylko wtedy, gdy status to PENDING.

Szczegóły błędu dla zadań zakończonych niepowodzeniem. Zobacz Błędy, aby uzyskać pełną referencję obiektu task_error.

Liczba kredytów zużytych przez to zadanie. Zwraca 0 dla zadań FAILED (kredyty są zwracane w przypadku niepowodzenia).

Adresy URL do pobrania wygenerowanych artefaktów, indeksowane według nazwy artefaktu. Zestaw kluczy zależy od output.format i options.light_source_preset: