lowpoly zostanie wycofany 30 paź 2026. Zmień model przed tymi datami, aby uniknąć błędów żądań. Zobacz wszystkie wycofania

Dziennik zmian

Zobacz wszystkie najnowsze funkcje i aktualizacje Meshy API oraz wtyczek.

Wolisz aktualny na żywo kanał informacyjny? Najnowsze wpisy pojawiają się również na stronie przeglądu Developer Platform.

Listopad 2026

Nov 3

  • Dodano texture_model do Obraz na 3D oraz Wiele obrazów na 3D, dzięki czemu model tekstury wybierasz w tym samym zadaniu co siatkę. Obraz na 3D przyjmuje Meshy 7 (meshy-7), Meshy N1 (meshy-n1) oraz Meshy 6 Lite (meshy-6-lite) z dowolnym ai_model. Wiele obrazów na 3D przyjmuje modele tekstury z wieloma widokami, Meshy 7 i Meshy N1. Każdy model tekstury zachowuje własne limity; zobacz Modele. Zadanie kosztuje tyle, co cena samej siatki dla danego ai_model, plus cena Reteksturowania przy odpowiedniej rozdzielczości tekstury; zobacz Cennik. Żądania bez texture_model działają tak jak wcześniej.
  • Dodano ai_model: "meshy-n1" do refine w Tekst na 3D. Bez texture_image_url Meshy N1 teksturuje na podstawie obrazu referencyjnego zapisanego przez podgląd Meshy 7.1 lub latest. Inne podglądy wymagają texture_image_url. Refine z Meshy N1 kosztuje 10 kredytów.

2 lis

  • Dodano ai_model: "meshy-n1" do API Reteksturowania. Meshy N1 tworzy teksturę koloru podstawowego 2K na podstawie od jednego do czterech obrazów referencyjnych. W przypadku więcej niż jednego obrazu pierwszy jest widokiem z przodu, a kolejność pozostałych nie ma znaczenia, podobnie jak w przypadku Meshy 7. Nie przyjmuje promptu tekstowego, nie tworzy map PBR ani tekstur 4K i 8K, i teksturuje modele 3D o maksymalnie 7 999 999 ścianach. Zadanie kosztuje 10 kredytów, tyle samo co Reteksturowanie 2K; zobacz Cennik. latest nadal wskazuje na Meshy 7.

Październik 2026

Oct 30

  • Niektóre żądania Meshy T1 (model_type: "lowpoly" lub ai_model: "meshy-t1") w Tekst na 3D i Obraz na 3D działają teraz w oparciu o Smart Topology, a pozostałe zwracają 400. model_type: "smart-topology" z ai_model: "meshy-t2.5" zastępuje T1. Od 30 listopada 2026 roku każde żądanie T1 będzie zwracać 400. Lista żądań, które nadal działają, znajduje się w sekcji Deprecations.
  • Auto Split API otrzymało nowy opcjonalny parametr, keep_texture. Przy keep_texture: true każda część modelu z teksturą zachowuje teksturę, a zadanie zwraca mapy tekstur w texture_urls, wraz z plikiem mtl oraz OBJ. Bez tego parametru podział działa tak jak wcześniej. Podział z zachowaniem tekstury trwa około dwa razy dłużej i nadal kosztuje 10 kredytów. input_task_id akceptuje teraz również zadania Refine Tekst na 3D oraz Reteksturowanie.

Oct 26

  • Nowa strona Przestarzałe funkcje: cykl życia każdego modelu generowania 3D (aktywny, legacy, przestarzałe lub wycofany) wraz z datą wycofania i zalecanym zamiennikiem, historia każdego wycofania API oraz przestarzałe parametry, które nadal są obsługiwane. Baner wycofania na stronach API prowadzi teraz do tej strony.

Oct 23

  • Oznaczono texture_image_url jako przestarzałe w Rigging. Meshy korzysta z tekstur osadzonych w pliku model_url lub z tekstur zadania wejściowego, więc jeśli model ma własne tekstury, należy pominąć ten parametr. Jeśli go wyślesz, obraz stanie się jedyną teksturą zriggowanego modelu, a model utraci swoje mapy PBR.

Oct 21

  • Dodano nagłówek X-Meshy-Metadata dla zespołów Studio i Enterprise do każdego punktu końcowego, który tworzy zadanie, z wyjątkiem punktów końcowych Creative Lab. Oznacz zadanie własnymi parami klucz-wartość, takimi jak user=alex@example.com,team=fab, i odczytuj je z powrotem w polu metadata rekordów Usage. Zobacz Metadata.

Oct 19

  • export_resolution akceptuje teraz wartości do 512, zamiast dotychczasowych 2048, w zadaniach budowania Keychain i Fridge Magnet. 512 to rozdzielczość mapy głębi, z której budowana jest geometria, więc każda wartość powyżej niej umieszczała dodatkowe wierzchołki pomiędzy już istniejącymi próbkami, dając większy plik opisujący tę samą powierzchnię. 512 jest również wartością domyślną, więc wywołania, które nigdy nie ustawiają export_resolution, pozostają bez zmian. Wartość powyżej 512 zwraca teraz 400 w momencie tworzenia zamiast być akceptowana. W szczególności 2048 zawsze przekraczało limit czasu generatora i kończyło się niepowodzeniem po rozpoczęciu zadania. Jeśli ustawiasz export_resolution powyżej 512, usuń ten parametr lub ustaw go na 512.

Oct 15

  • Dodano ai_model: "meshy-t2.5" do interfejsów API Obraz na 3D oraz Tekst na 3D: najnowszy model Smart Topology, zapewniający ostrzejsze szczegóły dla zasobów gier. Użyj go z model_type: "smart-topology"; wynik zawiera wyłącznie trójkąty, a target_polycount przyjmuje wartości od 100 do 30 000 (domyślnie 15 000). Cennik jest taki sam jak dla meshy-t2; zobacz Cennik. Jest to teraz model domyślny, gdy ustawiono model_type: "smart-topology" bez ai_model; aby nadal używać Meshy T2, ustaw ai_model: "meshy-t2". Wiele obrazów na 3D nie obsługuje meshy-t2.5.

Oct 14

  • model_url obsługuje teraz pliki o rozmiarze do 400 MB, w porównaniu do wcześniejszych 100 MB, gdy jest to URL typu http lub https, w Reteksturowanie, Remesh, Rigging, Konwertuj, Zmień rozmiar, Rozwinięcie UV, Druk wielokolorowy, Analizuj drukowalność oraz Napraw drukowalność. URI typu data: pozostaje ograniczone do 100 MB. Plik GLB, glTF, FBX lub OBJ o rozmiarze powyżej 100 MB może mieć co najwyżej 10 000 000 ścianek (8 000 000 w przypadku druku wielokolorowego), liczonych jako trójkąty; plik przekraczający ten limit zwraca 400. Powyżej 100 MB plik FBX musi być binarnym plikiem FBX w wersji 7.1 lub nowszej, a plik GLB lub glTF nie może korzystać z kompresji Draco. Plik jest pobierany przed zwróceniem odpowiedzi na żądanie utworzenia zadania, dlatego w przypadku dużych plików należy uwzględnić do 120 sekund (zobacz Cykl życia zadania). Pliki o rozmiarze 100 MB lub mniejszym działają jak dotychczas, a cennik pozostaje bez zmian.
  • Analizuj drukowalność zwraca teraz dla input_task_id należącego do innego konta odpowiedź 404 z taką samą treścią jak w przypadku identyfikatora, który nie istnieje, zamiast 403. Zadanie należące do Ciebie lub do członka zespołu w obszarze roboczym, do którego należysz, działa tak jak dotychczas.

12 paź

  • Pliki USDZ używają teraz metrów, dzięki czemu modele otwierają się w rzeczywistym rozmiarze w AR Quick Look, Reality Composer, Blenderze i innych przeglądarkach USD. Plik usdz w model_urls zadań Tekst na 3D, Obraz na 3D, Wiele obrazów na 3D, Reteksturowanie, Remesh, Konwertuj, Zmień rozmiar oraz Auto Split deklaruje teraz metersPerUnit = 1. Do tej pory deklarował stopy (metersPerUnit = 0.3048), podczas gdy jego współrzędne były w metrach, przez co model wyświetlał się w 30,48% swojego rozmiaru. Jeśli skalujesz pliki USDZ przez 3,28, aby to skompensować, usuń to skalowanie w przypadku zadań utworzonych od tej daty. Pliki wcześniejszych zadań zachowują swoją obecną jednostkę, a pliki USDZ z funkcji Rigging i Animacja nie są objęte tą zmianą.

10 paź

  • meshy-5 został wycofany. Żądania wysyłające ai_model: "meshy-5" do Tekst na 3D, Obraz na 3D, Wiele obrazów na 3D lub Reteksturowanie zwracają teraz kod 400 z komunikatem ai_model meshy-5 has been retired; use meshy-6-lite. Przejdź na meshy-6-lite, który przyjmuje te same parametry przy takim samym koszcie w kredytach. Modele już wygenerowane za pomocą meshy-5 pozostają dostępne, a refine podglądu meshy-5 bez ustawiania ai_model nadal działa.
  • .webp jest teraz udokumentowany jako obsługiwany format wejściowy obrazu, obok .jpg, .jpeg i .png, w Obraz na 3D, Wiele obrazów na 3D, Obraz na obraz, Reteksturowanie (image_style_url) oraz Tekst na 3D Refine (texture_image_url). Działa zarówno dla publicznych adresów URL, jak i identyfikatorów URI danych (data:image/webp;base64,...). Istniejące integracje nie są naruszone, a cennik pozostaje bez zmian.
  • Pobierz saldo zwraca teraz również monthly_credits, permanent_credits oraz monthly_resets_at, dzięki czemu możesz sprawdzić, jaka część Twojego salda wygaśnie przy następnym odświeżeniu. Samo pole balance pozostaje bez zmian.

Oct 6

  • Funkcje Analizuj drukowalność oraz Napraw drukowalność mogą teraz sprawdzać grubość ścianki w rozmiarze, w jakim planujesz drukować. Wyślij printer_type, rozmiar wydruku lub oba te parametry. Analiza zgłasza cienkie ścianki w printability.thin_walls, a naprawa w razie potrzeby je pogrubia i może ponownie wykorzystać drukarkę oraz rozmiar z zadania analizy przekazanego jako input_task_id. Integracje, które nie korzystają z tych pól, działają tak jak dotychczas, a Cennik pozostaje bez zmian.

Wrzesień 2026

Sep 29

  • Przestarzała ścieżka /v2/text-to-3d (bez prefiksu /openapi) jest przestarzała. Nadal działa bez zmian, ale zostanie usunięta w przyszłej wersji. Przejdź na /openapi/v2/text-to-3d, która przyjmuje to samo żądanie i zwraca tę samą odpowiedź. Odpowiedzi na przestarzałej ścieżce zawierają teraz nagłówek Deprecation oraz nagłówek Link wskazujący na nową ścieżkę.

Sep 28

  • Odpowiedzi API zawierają teraz nagłówki limitu szybkości, w tym Retry-After, który informuje, jak długo czekać przed ponowną próbą lub odpytywaniem.
  • Druk wielokolorowy akceptuje nowy parametr printer_brand, który zapisuje odpowiedni profil slicera w pliku 3MF, dzięki czemu plik otwiera się gotowy do druku na drukarkach Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker i AnkerMake, a także Bambu Lab (wartość domyślna). Strona dokumentuje teraz również max_depth.

18 wrz

  • Dodano meshy-7.1 jako wartość ai_model dla Obraz na 3D, Wiele obrazów na 3D oraz Tekst na 3D: te same parametry i koszt kredytów co meshy-7, wyższy poziom szczegółowości geometrii. latest wskazuje teraz na meshy-7.1; meshy-7 jest przestarzałe, ale nadal działa bez zmian.
  • Dodano geometry_resolution (standard / 2k / 4k) do tych samych API, zastępując przestarzałe już ultra_mode (ultra_mode: true nadal działa i odpowiada wartości "2k"). 4k wymaga Meshy 7.1 (meshy-7.1 lub latest), nie jest dostępne w Wiele obrazów na 3D i kosztuje tyle samo dodatkowych 5 kredytów co 2k.

Sep 16

  • Auto Split API teraz akceptuje teksturowany input_task_id. Wcześniej odrzucał go z kodem 400, co oznaczało konieczność ponownego wygenerowania tej samej siatki z should_texture: false, aby ją podzielić. Podział przecina geometrię i odbudowuje powierzchnie każdej części, więc tekstura wejściowa nie jest przenoszona, a wynikiem jest model bez tekstury z jednym jednolitym kolorem na część. Dotyczyło to już każdego podziału i pozostaje bez zmian.
  • meshy-5 zostanie wycofany 10 października 2026 r. Nie jest już udokumentowany jako wartość ai_model dla Tekst na 3D, Obraz na 3D, Wiele obrazów na 3D ani Reteksturowania, a po 10 października żądania wysyłające ai_model: "meshy-5" będą zwracać błąd.
  • Współdzielony klucz API trybu testowego został wycofany; żądania, które nadal go wysyłają, zwracają teraz 401 Unauthorized. Jeśli skopiowałeś go do kodu lub CI, zastąp go własnym kluczem ze strony API Keys. Ten klucz zawsze zwracał ten sam przykładowy model niezależnie od danych wejściowych, więc nigdy nie pokazywał, co faktycznie wygenerowałoby żądanie. Aby zobaczyć, co zwraca API przed rozpoczęciem pracy z nim, skorzystaj z Playground w Developer Platform, który uruchamia prawdziwe zadanie w przeglądarce. W planach bez dostępu do API uruchamia Obraz na 3D bez klucza API i wykorzystuje kredyty Twojego konta jak każde inne zadanie.

Sep 15

  • Dodano wartości gpt-image-2-5-flare oraz gpt-image-2-5-sunburst do udokumentowanych wartości ai_model dla API Tekst na obraz oraz Obraz na obraz. Są to warianty OpenAI GPT Image 2.5, wycenione tak samo jak gpt-image-2 (Tekst na obraz: 9 kredytów; Obraz na obraz: 12 kredytów).
  • Modele GPT Image (gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst) obsługują teraz również proporcje 4:3 i 3:4 w API Tekst na obraz oraz Obraz na obraz, oprócz 1:1, 16:9, 9:16, 3:2 i 2:3.

Sep 14

  • API Obraz na obraz akceptuje teraz input_task_id, dzięki czemu możesz łączyć zadania bezpośrednio z ukończonego zadania Tekst na obraz lub Obraz na obraz, zamiast kopiować jego adresy URL wyjściowe do reference_image_urls.

Sep 11

  • Zmiana zachowania: wywołanie DELETE dla zadania, które jest już w stanie IN_PROGRESS, jest teraz odrzucane z kodem 409 Conflict, a zadanie pozostaje uruchomione. Wcześniej zwracało 200 OK, zatrzymywało proces roboczy i odrzucało wynik, ale zachowywało kredyty, ponieważ tylko zadania PENDING podlegają zwrotowi. Takie wywołanie kosztowało zarówno model, jak i kredyty, a odpowiedź niczego o tym nie mówiła. Jeśli Twoja integracja usuwa zadania w celu ich anulowania, pamiętaj, że zadanie, które proces roboczy już rozpoczął, nie może zostać anulowane. Poczekaj na SUCCEEDED, FAILED lub CANCELED, a następnie je usuń. Zadania PENDING są nadal usuwane i zwracane dokładnie tak jak wcześniej, a zadania w stanie końcowym są nadal usuwane. Dotyczy to wszystkich rodzin zadań w /openapi. Zobacz Błędy.
  • Dodano meshy-6-lite do udokumentowanych wartości ai_model dla API Tekst na 3D, Obraz na 3D, Wiele obrazów na 3D oraz Reteksturowanie. Jest to następca meshy-5: te same parametry, ten sam koszt kredytów (5 za siatkę, 15 z teksturą, 10 za reteksturowanie).
  • meshy-5 jest teraz przestarzałe we wszystkich API, które go akceptują. Nadal działa i nic w Twoim żądaniu ani rachunku się nie zmienia, ale w przyszłej wersji przestanie przyjmować nowy ruch. Jeśli Twoja integracja wysyła ai_model: "meshy-5", przejdź na meshy-6-lite.

Sep 9

  • Nowe Auto Split API: Dzieli nieteksturowany model Meshy 6 lub Meshy 7 na osobno drukowalne części. Dzieli automatycznie, według części, które nazwiesz (by_parts), lub według obszaru koloru (by_color), z opcjonalnymi łącznikami czopowo-wpustowymi i wzmocnieniem cienkich ścian. Eksportuje każdą część jako osobny obiekt w formacie glb, obj, fbx, usdz, blend lub 3mf, zarówno złożone, jak i rozmieszczone na platformie roboczej (layout). 10 kredytów za zadanie.

Sep 7

  • Dodano parametr name_text do etapu prototypu Creative Lab Keychain API: wygrawerowanie na breloku imienia o długości do 10 znaków, taka sama personalizacja, jaką oferuje aplikacja webowa. Etap budowy automatycznie dziedziczy grawerunek, a obiekt zadania prototypu zwraca teraz name_text, dzięki czemu możesz potwierdzić dokładny tekst przed rozpoczęciem budowy. name pozostaje jedynie etykietą zadania do wyświetlania i nie jest grawerowane.

5 wrz

  • Dodano Creative Lab Fidget Pixel API: zamienia zdjęcie w wielokolorową planszę fidget w stylu pixel-art, możliwą do wydrukowania w 3D, w dwóch etapach. POST /prototype (6 kredytów) pikselizuje zdjęcie, zamieniając je w obraz pixel-art. Przekaż type jako person lub other, aby wybrać styl pikselizacji. POST /build (30 kredytów) próbkuje obraz na siatkę 16 lub 32 i zamienia każdy piksel w zazębiający się element square lub hex, dostarczany jako pojedynczy plik 3MF z oznaczeniami kolorów, przeznaczony do druku wielofilamentowego. Geometria elementów jest konfigurowalna za pomocą piece_size_mm, color_count oraz piece_height_mm.

Sep 4

  • Dodano GET /openapi/v1/animations/library do Biblioteki animacji: pobiera każdą gotową akcję akceptowaną przez Animation API (action_id, nazwę, kategorię oraz podgląd w formie animowanego GIF-a) wraz z filtrami wyszukiwania i kategorii, dzięki czemu możesz zbudować własny wybór akcji zamiast przeglądać tabelę referencyjną. Bezpłatne; nie zużywa kredytów.
  • Dodano Creative Lab Collapsible Fidget API: zamienia zdjęcie w drukowany „na gotowo” składany fidget spinner, w którym sylwetka obiektu staje się zagnieżdżonymi, współśrodkowymi pierścieniami, które można spłaszczyć i ponownie rozciągnąć, wydrukowany w jednym elemencie bez konieczności montażu. Pojedyncze żądanie POST prowadzi od obrazu aż do gotowego modelu. Nie ma tu pary etapów prototyp/kompilacja ani parametrów geometrii do dostrajania. Każde zadanie kosztuje 6 kredytów i zwraca plik STL gotowy do druku, a także plik GLB do podglądu, gdy Meshy jest w stanie go wygenerować.

Sep 3

  • Etap prototypu Creative Lab Lamp API zwraca teraz model 3D. POST /prototype zamienia obraz koncepcyjny w pusty w środku klosz lampy GLB, a obiekt zadania prototypu zyskuje model_urls.glb oraz thumbnail_url obok image_urls. Etap budowy uruchamia na tym modelu wyłącznie procesor lampy i generuje teraz klosz lampy z otwartym spodem oraz płytą podstawy pod oprawę źródła światła. Cennik zmienia się wraz z zakresem prac. Prototyp kosztuje 30 kredytów, a budowa 6 kredytów (wcześniej odpowiednio 6 i 30). Parametr text prototypu został usunięty, a image_url jest teraz wymagany.

Sep 2

  • Animation API akceptuje teraz action_ids, dzięki czemu możesz zastosować do 10 gotowych akcji do riggowanej postaci w jednym żądaniu i otrzymać pojedynczy plik zawierający jeden klip animacji na każdą akcję, gotowy do sterowania z poziomu maszyny stanów w silniku gry. Klipy zachowują kolejność, w jakiej je wymieniono, i noszą nazwę biblioteki animacji. Koszt to 3 kredyty za akcję, a post_process dotyczy scalonego pliku. Dostępne identyfikatory znajdziesz w Animation Library Reference, a cennik w tabeli cen.

1 wrz

  • Dodano parametr ultra_mode do API Wiele obrazów na 3D: umożliwia generowanie Ultra dla ai_model meshy-7 (lub latest) w celu uzyskania geometrii o wyższej wierności z bardziej precyzyjnymi detalami powierzchni, za dodatkowe 5 kredytów. To ten sam przebieg Ultra, który oferuje API Obraz na 3D, teraz dostępny również dla danych wejściowych z wieloma widokami.
  • Usunięto meshy-t1 z udokumentowanych wartości ai_model dla model_type Smart Topology w API Obraz na 3D. Smart Topology dokumentuje teraz wyłącznie meshy-t2; nowe integracje powinny korzystać z tej wartości. Planowane jest wycofanie Meshy T1. Jeśli Twoja integracja obecnie wysyła ai_model: "meshy-t1", przejdź na meshy-t2.

Sierpień 2026

Aug 28

  • Dodano Usage API dla zespołów Studio i Enterprise: programowy eksport historycznych danych o wykorzystaniu zadań API (endpoint, status, znaczniki czasu, klucz API, który uruchomił każde zadanie, oraz consumed_credits) ze standardowym stronicowaniem oraz filtrami według przedziału czasu, endpointu i statusu — na potrzeby śledzenia kosztów i systemów finansowych.

Aug 26

  • Animation API akceptuje teraz motion_task_id, dzięki czemu można zastosować klip ruchu wygenerowany za pomocą Text to Motion API na swojej riggowanej postaci dwunożnej, jako alternatywę dla gotowego action_id. Koszt pozostaje taki sam — 3 kredyty za zadanie.

Aug 24

  • Rozszerzono obsługę aspect_ratio dla gpt-image-2 w API Tekst na obraz i Obraz na obraz, dodając wartości 16:9 i 9:16. gpt-image-2 obsługuje teraz 1:1, 16:9, 9:16, 3:2 oraz 2:3; 4:3 i 3:4 nadal nie są obsługiwane dla tego modelu.

Aug 21

  • Dodano Text to Motion API: generuj klip ruchu postaci na podstawie opisu w języku naturalnym, bez konieczności posiadania modelu postaci. Wybierz mode prime (10 kredytów, wynik w formacie FBX) dla najwyższej jakości lub mode swift (3 kredyty, wynik w formacie BVH) dla szybkiej i ekonomicznej generacji, z czasem trwania klipu od 2 do 10 sekund.

Aug 20

  • Dodano parametr style do Multi-Color Print API: wybierz realistic (domyślnie) dla kolorów zgodnych z teksturą lub cartoon dla płaskich, jednolitych obszarów kolorów i mniejszego pliku 3MF.
  • Dodano parametr remove_background do każdego punktu końcowego prototypów Creative Lab: Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet oraz Lamp. Ustaw remove_background: true, aby otrzymać obraz prototypu jako przezroczysty plik PNG w formacie RGBA z usuniętym tłem.

Aug 18

  • Dodano parametr texture_image_urls do API Wiele obrazów na 3D: umożliwia podanie od 1 do 4 obrazów tego samego obiektu, aby ukierunkować teksturowanie, zamiast pojedynczego texture_image_url. Wymaga ai_model meshy-7 lub latest i jest niezależny od image_urls. Obie listy mogą zawierać różne obrazy oraz różną liczbę obrazów.

Aug 17

  • Dodano parametr remove_background do API Tekst na obraz oraz API Obraz na obraz. Ustaw remove_background: true, aby otrzymać wygenerowany obraz jako przezroczysty plik PNG w formacie RGBA z usuniętym tłem.

Aug 13

  • Dodano ai_model: "meshy-7" do API Tekst na 3D: nasz najnowszy model generowania 3D, zapewniający geometrię o wyższej wierności niż Meshy 6. Wprowadza on również parametr ultra_mode w zadaniu preview, który włącza generowanie Ultra dla jeszcze dokładniejszych detali powierzchni za dodatkowe 5 kredytów. Aby teksturować za pomocą Meshy 7, przekaż ai_model: "meshy-7" w zadaniu refine lub całkowicie pomiń ai_model.
  • Dodano model_type o nazwie Smart Topology do API Tekst na 3D. Ustaw model_type: "smart-topology", aby generować za pomocą meshy-t2: czystsza topology, natywnie rozdzielone części, wynik w postaci trójkątów oraz liczba ścian, którą można ustawić za pomocą target_polycount (od 100 do 15 000, domyślnie 4 000). Podgląd Smart Topology kosztuje 5 kredytów zamiast 20; zobacz Cennik. Istniejący model_type: "lowpoly" jest teraz przestarzałe, ale nadal obsługuje ruch ze względu na kompatybilność wsteczną.

Aug 12

  • Dodano ai_model: "meshy-7" do Image to 3D API: naszego najnowszego modelu generowania 3D, z geometrią o wyższej wierności niż Meshy 6. Wprowadza również parametr ultra_mode, który włącza generowanie Ultra dla jeszcze dokładniejszych detali powierzchni.
  • Dodano ai_model: "meshy-7" do Multi-Image to 3D API: modelu generowania wielowidokowego firmy Meshy, który uwzględnia wszystkie dostarczone widoki wejściowe jednocześnie i na ich podstawie steruje teksturowaniem.
  • Dodano ai_model: "meshy-7" do Retexture API: naszego najnowszego modelu teksturowania, z ostrzejszymi detalami powierzchni i czystszymi materiałami PBR niż Meshy 6. Wprowadza również parametr multiview_image_urls. Podaj od 1 do 4 uporządkowanych widoków tego samego obiektu, aby sterować teksturowaniem wielowidokowym.

Aug 4

  • Rozszerzono obsługę wejścia model_url do formatów .glb, .gltf, .obj, .fbx, .stl dla endpointów Analizuj drukowalność i Napraw drukowalność (wcześniej .glb, .stl, .obj). Naprawa zwraca naprawiony asset w jego formacie wejściowym.

July 2026

Jul 27

  • Nowe Creative Lab Brick Figure API: zamień zdjęcie w kolekcjonerską figurkę 3D w stylu klocków. Wykorzystuje ten sam dwuetapowy przepływ pracy co Figure API. prototype (6 kredytów) generuje stylizowany obraz koncepcyjny, a build (30 kredytów) przekształca go w teksturowany model 3D z wynikami w formatach GLB oraz OBJ + MTL. Pełne zestawienie znajdziesz w Cenniku.

22 lip

  • Nowe Creative Lab Keycap API: zamienia zdjęcie w pełnokolorowy, niestandardowy keycap do klawiatury mechanicznej. Wykorzystuje dwuetapowy proces pracy. prototype (12 kredytów) generuje render gotowego projektu keycapa, a następnie build (50 kredytów) zamienia wybrany przez Ciebie projekt (za pomocą candidate_id) w teksturowany model 3D keycapa z plikami wyjściowymi w formatach GLB i OBJ, eksportowanymi w rzeczywistej skali milimetrowej. Obecnie obsługiwana jest standardowa podstawa Cherry MX 1u (cherry-mx-1x1-r1); planowane są kolejne standardowe rozmiary. Pełne zestawienie znajdziesz w Cenniku.

Jul 21

  • Obsługujemy teraz tekstury koloru bazowego 8K dzięki nowemu parametrowi texture_resolution (2k / 4k / 8k) w endpointach Obraz na 3D, Wiele obrazów na 3D, Tekst na 3D Refine oraz Reteksturowanie. Przy 8k mapy PBR są generowane w rozdzielczości 4K i nie jest tworzona mapa emisji. Generowanie tekstury 8K kosztuje 15 kredytów (2k/4k pozostają na poziomie 10). Zobacz Cennik.
  • Parametr logiczny hd_texture jest przestarzałe na rzecz texture_resolution. Jest nadal obsługiwany i równoważny texture_resolution: "4k" dla zachowania zgodności wstecznej.

Jul 20

  • Nowe Creative Lab Vinyl Figure API: zamień zdjęcie w winylową figurkę kolekcjonerską 3D z dużą głową. Wykorzystuje ten sam dwuetapowy proces, co Figure API. prototype (6 kredytów) generuje stylizowany obraz koncepcyjny, a build (30 kredytów) zamienia go w teksturowany model 3D z wynikami w formatach GLB oraz OBJ + MTL. Pełne zestawienie znajdziesz w sekcji Cennik.

Jul 13

  • Dodano nowy typ Smart Topology model_type do API Obraz na 3D, oferujący dwa modele poprzez ai_model: meshy-t1 (obecny model low-poly) oraz meshy-t2 (nowy model z czystszą topology, natywnie rozdzielonymi częściami, wynikiem w postaci trójkątów oraz liczbą ścianek, którą można ustawić za pomocą target_polycount). meshy-t2 jest domyślny w ramach smart-topology. Istniejący model_type: lowpoly jest teraz przestarzałe, ale nadal obsługuje ruch ze względu na wsteczną kompatybilność.

Jul 7

  • Dodano parametr aspect_ratio do API Obraz na obraz, dzięki czemu można kontrolować proporcje obrazu wyjściowego podczas edycji. Dozwolone wartości to 1:1, 16:9, 9:16, 4:3, 3:4 dla modeli nano-banana oraz 1:1, 3:2, 2:3 dla gpt-image-2. Parametr opcjonalny; domyślnie 1:1, nie można go łączyć z generate_multi_view.

June 2026

Jun 17

  • Nowa strona dokumentacji API Playground: interaktywna konsola umożliwiająca testowanie endpointów bez pisania kodu, a następnie skopiowanie odpowiedniego kodu w cURL, Pythonie lub JavaScript. Dostępna w planach Pro, Premium, Ultra, Studio i Enterprise.

Jun 15

  • Nowe UV Unwrap API: generuje wysokiej jakości układ UV dla istniejącego modelu 3D (krok wymagany przed teksturowaniem lub w dowolnej sytuacji, gdy potrzebujesz czystego, nienachodzącego na siebie układu UV do dalszej obróbki w innych narzędziach). Przyjmuje input_task_id (zakończone zadanie Obraz na 3D, Tekst na 3D lub Remesh) albo model_url (wyłącznie .glb) i zwraca „biały model UV” z zupełnie nowymi współrzędnymi UV. 5 kredytów za wywołanie. Obsługuje siatki o maksymalnie 40 000 ścian (jeśli siatka jest większa, najpierw uruchom Remesh); siatki z czworokątami i n-kątami są triangulowane podczas generowania UV.

12 cze

  • Zaktualizowano cennik Build w Creative Lab API do 30 kredytów za wywołanie dla brelok, magnes na lodówkę oraz figurka (wcześniej 20). lampa pozostaje bez zmian — 30 kredytów. Cennik Prototype pozostaje bez zmian — 6 kredytów za obraz. Pełne zestawienie znajduje się w Cennik.

5 cze

Jun 1

  • Nowe API Creative Lab: rodzina endpointów przypisanych do konkretnych produktów, które zamieniają zdjęcie źródłowe (lub prompt tekstowy) w produkt konsumencki gotowy do druku 3D. Na start dostępne są cztery produkty: brelok, magnes na lodówkę, figurka oraz lampa. Każdy z nich wykorzystuje dwuetapowy przepływ pracy prototype → build, połączony za pomocą input_task_id, obsługiwany pod adresami URL przypisanymi do danego produktu (/openapi/creative-lab/<product>/v1/...), z wersjonowaniem dla każdego produktu, dzięki czemu produkty mogą rozwijać się na niezależnych liniach wersji. Prototype: 6 kredytów za wywołanie. Build: 30 kredytów za wywołanie.

Maj 2026

26 maja

  • Dodano parametr multi_view_thumbnails do API Wiele obrazów na 3D. Gdy ustawiony jest na true, zadanie dodatkowo renderuje cztery miniatury z widokami w głównych kierunkach (przód, prawa strona, tył, lewa strona) i zwraca je w nowym polu odpowiedzi thumbnail_urls. Istniejące pole thumbnail_url pozostaje bez zmian. Zwiększa to opóźnienie zadania o około 3 sekundy.

22 maja

  • Funkcjonalność konwersji i zmiany rozmiaru z API Remesh jest teraz dostępna jako samodzielne endpointy API Konwertuj oraz API Zmień rozmiar. Przestarzałe parametry w Remesh nadal będą działać ze względu na kompatybilność wsteczną.

13 maja

  • Dodano parametr multi_view_thumbnails do API Obraz na 3D. Po ustawieniu na true zadanie dodatkowo renderuje cztery miniatury z widokami z czterech głównych stron (przód, prawo, tył, lewo) i zwraca je w nowym polu odpowiedzi thumbnail_urls. Istniejące pole thumbnail_url pozostaje bez zmian. Dodaje to około 3 sekund do opóźnienia wykonania zadania.

12 maja

  • Dodano parametr resize_longest_side do API Remesh. Zmienia rozmiar modelu tak, aby najdłuższy wymiar bounding boxa był równy podanej wartości w metrach. Wzajemnie wykluczający się z resize_height i auto_size.

11 maja

7 maja

  • Nowe Analyze Printability API: Analizuj drukowalność zakończonego powodzeniem zadania Meshy lub dowolnego adresu URL modelu 3D pod kątem gotowości do druku 3D w technologii FDM. Wzorzec asynchronicznego tworzenia i strumieniowania: żądanie POST zwraca task_id, a następnie zapytanie GET / strumień SSE zwraca metryki szczelności (watertightness), objętości, otworów oraz krawędzi non-manifold po osiągnięciu statusu SUCCEEDED. Funkcja darmowa, nie zużywa kredytów.
  • Nowe Repair Printability API: Napraw drukowalność modelu 3D pod kątem druku FDM, naprawiając krawędzie non-manifold, zdegenerowane ściany, otwory i inne problemy z topology. Akceptuje istniejący input_task_id z Meshy lub model_url (.glb, .stl, .obj). Format wyjściowy jest zgodny z formatem wejściowym. 10 kredytów za zadanie.

Kwiecień 2026

Apr 27

  • Dodano pole consumed_credits do wszystkich odpowiedzi zadań we wszystkich punktach końcowych API. Pokazuje liczbę kredytów zużytych przez każde zadanie. Pole jest obecne dla zadań o statusach PENDING, IN_PROGRESS i SUCCEEDED. Zwraca 0 dla zadań FAILED (kredyty są automatycznie zwracane w przypadku niepowodzenia). Zobacz Cennik, aby poznać koszty kredytów dla poszczególnych punktów końcowych.

Apr 24

  • Dodano parametr model_url do punktu końcowego Multi-Color Print. Prześlij teksturowany model 3D bezpośrednio (za pomocą adresu URL lub Data URI) zamiast input_task_id z poprzedniego zadania Meshy. Obsługiwane formaty: .glb, .fbx. Gdy podane są zarówno model_url, jak i input_task_id, priorytet ma input_task_id.

Apr 21

  • Dodano parametr input_task_id do endpointów Obraz na 3D i Wiele obrazów na 3D. Pozwala to na bezpośrednie odwołanie się do wyniku ukończonego zadania Tekst na obraz lub Obraz na obraz, zamiast podawania image_url / image_urls. Gdy podane są oba, priorytet ma input_task_id.

Apr 20

14 kwietnia

12 kwietnia

  • Zrestrukturyzowano dokumentację API: dodano grupowanie parametrów z polami zależnymi, wartości domyślne w linii, odznaki wymagane/przestarzałe, rozwijalną nawigację podrzędną oraz podzielono Multi-Image, Rigging i Animację na osobne strony.

Marzec 2026

Apr 2

  • Dodano obsługę formatu 3mf do parametru target_formats we wszystkich endpointach (Obraz na 3D, Tekst na 3D, Remesh, Reteksturowanie). Uwaga: 3MF jest opcją domyślnie wyłączoną i musi zostać jawnie zażądana.
  • Nowe Multi-Color Print API: Konwertuj modele 3D do formatu 3MF z obsługą wielu kolorów na potrzeby druku 3D. Obsługuje palety od 1 do 16 kolorów z konfigurowalną precyzją. 10 kredytów za zadanie.

Mar 20

  • Wycofano model AI Meshy-4. Wszystkie żądania API korzystające z meshy-4 nie są już obsługiwane. Przejdź na meshy-6 lub latest.
  • Dodano parametry auto_size i origin_at do endpointów Obraz na 3D, Wiele obrazów na 3D, Tekst na 3D oraz Remesh. Gdy auto_size jest włączone, usługa wykorzystuje wizję AI do oszacowania rzeczywistej wysokości i automatycznego zmienienia rozmiaru modelu. origin_at ustawia pozycję punktu początkowego (bottom lub center). W API Remesh parametr auto_size wyklucza się wzajemnie z resize_height.

Mar 17

February 2026

Feb 28

Feb 25

  • Dodano parametr image_enhancement do API Obraz na 3D i Wiele obrazów na 3D dla użytkowników, którzy chcą zrezygnować z optymalizacji obrazu wejściowego i zachować dokładny wygląd swojego wejścia. Obsługiwane tylko dla meshy-6 i latest. Domyślnie true.

Feb 20

  • Dodano parametr model_type do API Tekst na 3D Preview umożliwiający generowanie siatek low-poly zoptymalizowanych pod kątem czystszych wielokątów.

Styczeń 2026

Jan 27

  • Dodano szczegółową dokumentację Trybów awarii dla wszystkich punktów końcowych API, obejmującą typowe kody błędów HTTP (400, 401, 402, 404, 422, 429) oraz przyczyny niepowodzeń zadań. Ułatwia to programistom lepsze zrozumienie i obsługę błędów API.

Jan 26

  • API Wiele obrazów na 3D obsługuje teraz Meshy-6 do pełnego generowania siatki. Parametr ai_model akceptuje teraz wartość meshy-6, a latest jest rozwiązywane jako Meshy 6.

Jan 22

  • Oznaczono jako przestarzałe art_style w API Tekst na 3D Preview (Meshy-6). Parametr ten został zaprojektowany dla starszych modeli (Legacy) (Meshy-4 / Meshy-5) i zostanie usunięty w przyszłej wersji.
  • Oznaczono jako przestarzałe enable_pbr w API Tekst na 3D oraz Obraz na 3D, gdy ai_model ma wartość meshy-4. Ten parametr zostanie usunięty w przyszłej wersji.
  • Zaktualizowano domyślną wartość parametru should_remesh dla Meshy-6 w API Tekst na 3D oraz Obraz na 3D. Parametr domyślnie przyjmuje teraz wartość false dla meshy-6 oraz true dla pozostałych modeli, jeśli nie zostanie określony.

19 sty

12 sty

  • Dodano nowy parametr model_type do interfejsu API Obraz na 3D, umożliwiający generowanie siatek low-poly zoptymalizowanych pod kątem czystszych wielokątów.

Grudzień 2025

31 gru

  • Uruchomiono API Playground — dedykowaną przestrzeń dla deweloperów, umożliwiającą eksplorację parametrów API i testowanie zapytań bezpośrednio na stronie Meshy.
  • Wprowadzono Text to Image API oraz Image to Image API, umożliwiające generowanie obrazów przez AI na podstawie promptów tekstowych oraz edycję obrazów na podstawie obrazów referencyjnych. Oba interfejsy API obsługują modele nano-banana i nano-banana-pro, z opcjonalnym generowaniem w trybie Wiele widoków.

Dec 22

  • Pole video_url w odpowiedzi API Tekst na 3D jest teraz przestarzałe i zostanie usunięte w przyszłej wersji.

Dec 04

  • Dodano nowy parametr pose_mode do interfejsów API Tekst na 3D Preview, Obraz na 3D oraz Wiele obrazów na 3D. Ten parametr przyjmuje wartości a-pose, t-pose lub pusty ciąg znaków (domyślnie). Parametr is_a_t_pose jest teraz przestarzały na rzecz pose_mode.

Listopad 2025

Nov 24

  • Interfejsy API Obraz na 3D oraz Wiele obrazów na 3D zyskały opcjonalny parametr save_pre_remeshed_model oraz udostępniają model_urls.pre_remeshed_glb, gdy zażądano kopii zapasowej sprzed remeshu.

Nov 06

  • Text to 3D Refine API obsługuje teraz ai_model = latest, które wskazuje na Meshy 6 Preview.
  • Image to 3D API domyślnie korzysta teraz z teksturowania Meshy-6-preview, gdy ai_model = latest oraz should_texture = true.
  • Multi-Image to 3D API obsługuje teraz ai_model = latest, domyślnie uruchamiając Meshy-6-preview do teksturowania, podczas gdy generowanie siatki pozostaje oparte na Meshy-5.
  • Retexture API dodaje opcję latest dla ai_model (Meshy-6-preview) i domyślnie jej używa, jeśli parametr zostanie pominięty.

Nov 04

  • Remesh API zachowuje teraz tekstury dla przesłanych modeli.
  • Retexture API (Reteksturowanie) zachowuje teraz tekstury dla przesłanych modeli, gdy włączona jest opcja enable_original_uv.

Październik 2025

Oct 28

  • Dodano nagłówek odpowiedzi x-api-version, wskazujący aktualną wersję serwera API.

Oct 20

  • Dodano opcjonalny parametr logiczny convert_format_only do Remesh API, umożliwiający konwersję wyłącznie formatu przesłanego pliku modelu.
  • Dodano rigged_character_glb_url do odpowiedzi The Rigging Task Object.

Oct 01

  • Usunięto interfejsy API text-to-voxel

Wrzesień 2025

Sep 23

  • Dodano opcję latest dla ai_model w interfejsie API Tekst na 3D, aby korzystać z Meshy 6 Preview.
  • Wprowadzono tymczasową 50% zniżkę na zadania generowania Meshy-6-preview, obniżając koszt do 10 kredytów; zniżka obowiązuje do 30 września 2025. Po zakończeniu okresu obniżki koszt zadań Meshy-6-preview wróci do standardowych 20 kredytów.

Sep 18

16 wrz

  • Dodano opcję latest dla ai_model w API Obraz na 3D, umożliwiającą korzystanie z Meshy 6 Preview.

4 wrz

  • Rozszerzono obsługę wejścia model_url o formaty .glb, .gltf, .obj, .fbx, .stl dla funkcji Remesh i Reteksturowanie.

Sierpień 2025

18 sie

Aug 13

  • Meshy 5 jest teraz stabilny dla Tekst na 3D oraz Obraz na 3D (ai_model: meshy-5), zapewniając lepszą jakość i spójność.

Lipiec 2025

Jul 31

Czerwiec 2025

Jun 25

  • Dodano Retexture API, które umożliwia użytkownikom reteksturowanie modeli 3D w oparciu o najnowsze modele podstawowe AI firmy Meshy.

Jun 19

Jun 17

Jun 10

  • Remesh API obsługuje teraz modele w formacie GLB zakodowane w base64 w parametrze model_url za pomocą Data URI.

May 2025

May 20

May 15

  • Wprowadzono API do automatycznego riggingu i animacji (Auto-rigging & Animation API), umożliwiające użytkownikom automatyczne tworzenie rigu i animowanie modeli 3D. Dowiedz się więcej o Rigging oraz Animacji.

Kwiecień 2025

Apr 29

  • Wprowadzono API Wiele obrazów na 3D, umożliwiające generowanie modeli 3D na podstawie od 1 do 4 obrazów wejściowych przy użyciu modelu AI meshy-5.
  • Dodano opcję modelu AI meshy-5 do API Tekst na 3D oraz Obraz na 3D. Tag latest teraz również wskazuje na meshy-5.

17 kwietnia

  • Dodano parametr texture_image_url do API Obraz na 3D oraz Tekst na 3D Refine, umożliwiając użytkownikom kierowanie procesem generowania tekstury za pomocą obrazu.

Marzec 2025

28 marca

  • Dodano parametr latest do API Tekst na 3D oraz Obraz na 3D, umożliwiający dostęp do naszych nadchodzących zaawansowanych modeli AI zapewniających lepszą jakość generowania.

Mar 14

  • Text to Texture API obsługuje teraz modele zakodowane w base64 w parametrze model_url za pomocą Data URI, podobnie jak image_url w API Obraz na 3D.

Mar 06

  • Zaktualizowano cennik zadań generowania API:
    • Tekst na 3D (Preview): Zwiększono z 2 do 5 kredytów za wywołanie
    • Tekst na 3D (Refine): Zwiększono z 5 do 10 kredytów za wywołanie
    • Obraz na 3D: Teraz 5 kredytów bez tekstury, 15 kredytów z teksturą
    • Tekst na teksturę: Zwiększono z 5 do 10 kredytów za wywołanie
    • Tekst na Voxel: Pozostaje na poziomie 5 kredytów za wywołanie

Luty 2025

Feb 18

  • Dodano klucz API trybu testowego, który pozwala programistom testować integrację API bez zużywania kredytów. Wszystkie prawidłowe żądania wykonane przy użyciu tego klucza zwrócą te same przykładowe wyniki zadania.

Feb 13

  • Zmiany niekompatybilne wstecz:

    • Tworzenie zadań w poziomie bezpłatnym zakończy się 20 marca 2025. Po tej dacie wszystkie żądania zadań API będą wymagały płatnej subskrypcji. Aby zapewnić sobie nieprzerwany dostęp, zalecamy dokonanie aktualizacji przed upływem terminu.
    • Użyj kodu kuponu APIACCESS, aby otrzymać 40% zniżki. Dziękujemy, że jesteście z nami!

  • Dodano endpointy strumieniowania Server-Sent Events (SSE) umożliwiające aktualizacje zadań w czasie rzeczywistym:

Feb 6

  • Dodano parametr texture_prompt do API Obraz na 3D oraz Tekst na 3D Refine, umożliwiając użytkownikom kierowanie procesem generowania tekstury za pomocą promptu tekstowego.

January 2025

Jan 23

Jan 14

  • Oznaczono przestarzałe (Legacy) API Tekst na 3D i Obraz na 3D oparte na modelach AI Meshy-3.

Jan 07

December 2024

Dec 19

  • Dodano API Remesh, które pozwalają użytkownikom przeprowadzić remesh i wyeksportować istniejące modele 3D wygenerowane przez inne API Meshy do różnych formatów.
  • Zaktualizowano limity liczby wielokątów dla naszych API do zakresu od 100 do 300 000 dla użytkowników Premium.

Dec 12

  • Oznaczono parametr model_url jako przestarzałe we wszystkich obiektach odpowiedzi.
  • Rozdzielono starsze (legacy) API Meshy-3 od najnowszego API Meshy-4.

Dec 10

Dec 5

Dec 3

  • Zewnętrzne API korzystają teraz z prefiksu /openapi. Ścieżki Legacy są nadal obsługiwane, ale zalecamy przejście na nowe ścieżki.

Listopad 2024

Nov 14

  • API Obraz na 3D obsługuje teraz obrazy zakodowane w formacie base64.