Płaskorzeźba API

Zdjęcie do przekształcenia w płaskorzeźbę, podane jako publiczny adres URL lub Data URI (data:image/png;base64,...).

Obraz musi być plikiem JPG, JPEG, PNG lub WebP o rozmiarze maksymalnie 20 MB i co najmniej 32 × 32 piksele. Jego dłuższy bok może być co najwyżej około 16 razy dłuższy niż krótszy bok. Każdy inny obraz zwraca 400. Meshy wypełnia przezroczyste obszary kolorem czarnym przed zbudowaniem płaskorzeźby.

Styl płaskorzeźby. Kształtuje mapę głębi i ustawia domyślną wartość carving_depth_mm.

Dostępne wartości:

• high: głębsze rzeźbienie, do wydruków 3D.
• low: płytkie rzeźbienie, do grawerowania laserowego, grawerowania CNC i cienkich tabliczek.

Wysłanie null lub "" jest równoznaczne z pominięciem tego parametru. Każda inna wartość zwraca 400.

Czy zbudować model płaskorzeźby. Ustaw na false dla zadania generującego tylko mapę głębi, bez modelu i bez obrazu podglądu. Meshy nadal sprawdza parametry rozmiaru, rzeźbienia, podstawy, zgięcia i rozdzielczości, ale ich nie wykorzystuje. Nie zmienia to kosztu w kredytach.

Długość dłuższego boku zdjęcia na modelu, mierzona na płasko przed ewentualnym zgięciem, od 20 do 250 milimetrów. Przy użyciu remove_base model może być mniejszy.

Czy obiekt wystaje z płyty, czy jest w nią wcięty.

Dostępne wartości:

• emboss: bliższe części zdjęcia wystają.
• engrave: głębia jest odwrócona, więc bliższe części są wcięte.

Mapa głębi jest taka sama w obu trybach.

Jak głęboko wyrzeźbiona jest płaskorzeźba, od 0 do 60 milimetrów. Gdy remove_base jest ustawione na true, wartość 0 pozostawia pusty model. Zadanie nadal kończy się powodzeniem i kosztuje 20 kredytów, a jego pliki GLB i STL nie mają geometrii.

Czy wyciąć tło i nie budować podstawy. Gdy jest true, removal_threshold określa, co liczy się jako tło. Meshy sprawdza removal_threshold niezależnie od wartości tego parametru.

Grubość podstawy, od 0.1 do 10 milimetrów. Gdy remove_base jest true, pomiń ten parametr lub wyślij 0.

Czy zgiąć płaskorzeźbę i w którą stronę. Gdy nie jest off, bend_axis i bend_angle kształtują zgięcie. Meshy sprawdza je niezależnie od wartości tego parametru.

Dostępne wartości:

• off: płaska płaskorzeźba.
• convex: przód wybrzusza się na zewnątrz.
• concave: przód wygina się do wewnątrz.

Liczba punktów siatki wzdłuż dłuższego boku zdjęcia, od 512 do 2048. Wyższa wartość zachowuje drobniejsze szczegóły i tworzy większe pliki. Przy domyślnej wartości 1024 plik GLB ma około 40 do 50 MB, a plik STL około 80 do 105 MB. Zdjęcie kwadratowe daje większe rozmiary. Przy 2048 mają one około 150 MB i 300 MB. Zgięcie zwiększa ich rozmiar: plik STL może osiągnąć około 800 MB przy 2048.

Żądanie nie może zostać wykonane. Komunikat błędu wskazuje znaleziony problem. Na przykład:

• Brakujący parametr: nie wysłano image_url.
• Nieprawidłowy parametr: parametr ma niewłaściwy typ, jest poza swoim zakresem lub nie jest jedną z dostępnych wartości. Na przykład variant nie jest high ani low, albo mesh_resolution nie jest liczbą całkowitą od 512 do 2048.
• Grubość podstawy: base_thickness_mm nie jest 0 przy remove_base ustawionym na true, lub jest poniżej 0.1 bez tego ustawienia.
• Niedostępny adres URL: Meshy nie może pobrać obrazu spod image_url, na przykład dlatego, że adres URL zwraca 404 lub upłynął limit czasu.
• Nieprawidłowy obraz: obraz nie jest plikiem JPG, JPEG, PNG ani WebP, przekracza 20 MB, jest mniejszy niż 32 × 32 piksele, ma zbyt wiele pikseli lub nie można go odczytać.
• Skrajne proporcje: dłuższy bok obrazu jest ponad 16 razy dłuższy niż krótszy bok.

Popraw żądanie, a następnie wyślij je ponownie. Meshy nie nalicza za to opłaty. Zobacz Błędy.

Brak klucza API lub klucz API jest nieprawidłowy. Sprawdź nagłówek Authorization.

Na przykład:

• Niewystarczające kredyty: konto nie ma wystarczającej liczby kredytów na to zadanie lub konto osiągnęło limit kredytów. Sprawdź saldo kredytów, a następnie spróbuj ponownie.
• Plan darmowy: utworzenie zadania wymaga płatnego planu. Uaktualnij swój plan w ustawieniach subskrypcji, a następnie spróbuj ponownie.

Moderacja treści zablokowała obraz. Meshy nie nalicza opłaty za to żądanie. Wyślij inny obraz.

Osiągnięto jeden z tych limitów:

• Wysłano zbyt wiele żądań. Odczekaj, a następnie spróbuj ponownie. Zobacz Limity szybkości.
• Zbyt wiele Twoich zadań jest w kolejce lub w trakcie wykonywania. Poczekaj, aż niektóre się zakończą, a następnie spróbuj ponownie.
• W planie nielimitowanym bez pozostałych kredytów osiągnięto liczbę zadań, które mogą działać bez kredytów. Poczekaj na zakończenie zadania lub dodaj kredyty.

ID zadania z odpowiedzi utworzenia.

ID zadania do usunięcia.

Numer strony do zwrócenia. Zaczyna się od 1 i taka jest wartość domyślna.

Liczba zadań na stronę, maksymalnie 100. Domyślnie 10. Meshy traktuje wartość od 101 do 255 jako 100, a większa wartość zwraca 400.

Kolejność sortowania.

Dostępne wartości:

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

ID zadania z odpowiedzi tworzenia.

ID zadania. Traktuj je jako nieprzejrzysty ciąg znaków i nie polegaj na jego formacie.

Typ zadania, zawsze relief.

Adresy URL do pobrania modelu płaskorzeźby. Pliki mogą być duże; mesh_resolution zawiera typowe rozmiary.

Adres URL do pobrania 16-bitowej mapy głębi w skali szarości, na podstawie której zbudowano płaskorzeźbę. Jaśniejsze piksele są wyższe. Wartości to wysokości względne, a nie milimetry. Oprogramowanie do grawerowania laserowego i CNC może używać jej jako mapy wysokości. Plik ma od około 1 do 2 MB. Puste, jeśli żadnej nie ma.

Adres URL do pobrania podglądu modelu płaskorzeźby. Puste, jeśli żaden nie został wyrenderowany, w tym dla zadania obejmującego tylko mapę głębi.

Jak dużo z zadania zostało wykonane, w procentach. Wynosi 0, dopóki zadanie się nie rozpocznie, oraz 100, gdy zakończy się powodzeniem.

Status zadania, jeden z: PENDING, IN_PROGRESS, SUCCEEDED lub FAILED.

Liczba zadań poprzedzających to zadanie w kolejce. Pole jest pomijane, gdy wartość wynosi 0, więc pojawia się tylko wtedy, gdy przed tym zadaniem znajdują się inne zadania.

Czas utworzenia zadania, w milisekundach Unix.

Czas rozpoczęcia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie rozpocznie.

Czas zakończenia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie zakończy.

Czas wygaśnięcia wyniku zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie zakończy.

Szczegóły błędu, gdy zadanie zakończy się niepowodzeniem. Zobacz Błędy.

Liczba kredytów zużytych przez zadanie: 20, lub 0 dla zadania FAILED, które Meshy zwraca.