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

Dziennik zmian

Zobacz wszystkie najnowsze funkcje i aktualizacje Meshy API oraz wtyczek.

Wolisz źródło na żywo? Najnowsze wpisy pojawiają się również na stronie przeglądu Developer Platform.

Październik 2026

Oct 12

  • 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 zrekompensować, usuń to skalowanie w przypadku zadań tworzonych od tej daty. Pliki wcześniejszych zadań zachowują swoją dotychczasową jednostkę, a pliki USDZ z Rigging i Animacja nie są objęte tą zmianą.

Oct 10

  • 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 400 z komunikatem ai_model meshy-5 has been retired; use meshy-6-lite. Przełącz się na meshy-6-lite, który przyjmuje te same parametry przy tym 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 danych URI (data:image/webp;base64,...). Istniejące integracje nie są naruszone, a cennik pozostaje bez zmian.
  • Get Balance zwraca teraz również monthly_credits, permanent_credits oraz monthly_resets_at, dzięki czemu możesz zobaczyć, jaka część Twojego salda wygaśnie przy następnym odnowieniu. Samo pole balance pozostaje bez zmian.

Oct 6

  • Funkcje Analizuj drukowalność i Napraw drukowalność mogą teraz sprawdzać grubość ścianki przy 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 pogrubia je w razie potrzeby i może ponownie wykorzystać drukarkę oraz rozmiar zadania analizy przekazanego jako input_task_id. Integracje, które nie używają tych pól, działają tak jak wcześniej, 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 należy odczekać przed ponowną próbą lub odpytywaniem.
  • Multi-Color Print 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.

Sep 18

  • 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 w kredytach 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 oznaczony już jako przestarzały 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 obsługuje teraz teksturowany input_task_id. Wcześniej odrzucał go z kodem 400, co oznaczało konieczność ponownego wygenerowania tej samej siatki z should_texture: false tylko po to, aby ją podzielić. Zwróć uwagę, co zwraca podział: wycina geometrię i odbudowuje powierzchnie każdej części, więc tekstura wejścia nie jest przenoszona, a wynikiem jest model bez tekstury z jednym jednolitym kolorem na część — to dotyczyło już każdego podziału i nie uległo zmianie.
  • meshy-5 zostanie wycofany 10 października 2026 roku. 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 kluczy API. 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 on funkcję Obraz na 3D bez klucza API i wykorzystuje kredyty Twojego konta, tak jak każde inne zadanie.

Sep 15

  • Dodano gpt-image-2-5-flare oraz gpt-image-2-5-sunburst do udokumentowanych wartości ai_model dla interfejsów API Tekst na obraz i 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 interfejsach API Tekst na obraz i Obraz na obraz, oprócz 1:1, 16:9, 9:16, 3:2 i 2:3.

Sep 14

  • Image to Image API obsługuje teraz input_task_id — pozwala to na bezpośrednie połączenie z ukończonym zadaniem Tekst na obraz lub Obraz na obraz, zamiast kopiowania adresów URL jego wyników do reference_image_urls.

Sep 11

  • Zmiana zachowania: DELETE wykonane na zadaniu, które jest już w stanie IN_PROGRESS, jest teraz odrzucane z kodem 409 Conflict, a samo zadanie pozostaje uruchomione. Wcześniej zwracało 200 OK, zatrzymywało proces roboczy i odrzucało wynik — zachowując przy tym kredyty, ponieważ zwrotowi podlegają wyłącznie zadania w stanie PENDING. W efekcie wywołanie kosztowało zarówno model, jak i kredyty, a odpowiedź nie zawierała żadnej informacji o tym fakcie. 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 stan SUCCEEDED, FAILED lub CANCELED, a dopiero potem je usuń. Zadania w stanie PENDING są nadal usuwane i zwracane dokładnie tak jak wcześniej, a zadania w stanach końcowych są nadal usuwane. Dotyczy to wszystkich rodzin zadań w ramach /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 w kredytach (5 za siatkę, 15 z teksturą, 10 za reteksturowanie).
  • meshy-5 jest teraz przestarzałe we wszystkich API, które je obsługują. Nadal działa i nic nie zmienia się w Twoim żądaniu ani rozliczeniu, 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: Podziel niepokryty teksturą model Meshy 6 lub Meshy 7 na osobno drukowalne części — automatycznie, według nazwanych przez Ciebie części (by_parts) lub według obszarów kolorystycznych (by_color) — z opcjonalnymi łącznikami czop-wpust oraz wzmocnieniem cienkich ścian. Eksportuje każdą część jako osobny obiekt w formacie glb, obj, fbx, usdz, blend lub 3mf, zarówno w formie zmontowanej, jak i rozłożonej na platformie roboczej (layout). 10 kredytów za zadanie.

Sep 7

  • Dodano parametr name_text do etapu prototypu Creative Lab Keychain API: wygraweruj na breloku imię o długości do 10 znaków — tę samą personalizację 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. Zwróć uwagę, że name pozostaje jedynie etykietą zadania do wyświetlania i nie jest grawerowane.

5 wrz

  • Dodano Creative Lab Fidget Pixel API: zamienia zdjęcie w wieloskolorową planszę fidget w stylu pixel-art, gotową do druku 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 — a POST /build (30 kredytów) próbkuje go na siatce 16 lub 32 i zamienia każdy piksel w łączący się element square lub hex, dostarczany jako pojedynczy plik 3MF oznaczony kolorami do druku wielofilamentowego. Geometria elementów jest konfigurowalna za pomocą piece_size_mm, color_count i piece_height_mm.

Sep 4

  • Dodano GET /openapi/v1/animations/library do Biblioteki animacji: pobiera każdą gotową akcję, jaką akceptuje Animation API — action_id, nazwę, kategorię oraz podgląd w postaci animowanego GIF-a — wraz z filtrami wyszukiwania i kategorii, dzięki czemu możesz zbudować własny selektor akcji zamiast korzystać z tabeli referencyjnej. Darmowe; nie zużywa kredytów.
  • Dodano Creative Lab Collapsible Fidget API: zamienia zdjęcie w drukowaną od razu w całości, składaną zabawkę typu fidget, w której sylwetka obiektu staje się zagnieżdżonymi, współśrodkowymi pierścieniami, które można spłaszczyć i ponownie rozciągnąć, wydrukowaną jako jeden element bez konieczności montażu. Pojedyncze żądanie POST prowadzi od obrazu aż do gotowego modelu — nie występuje tu para etapów prototyp/build ani parametry geometrii do dostrojenia. Każde zadanie kosztuje 6 kredytów i zwraca zarówno plik STL nadający się do druku, jak i plik GLB do podglądu.

Sep 3

  • Etap prototypu w Creative Lab Lamp API zwraca teraz model 3D: POST /prototype zamienia obraz koncepcyjny w pusty w środku model GLB klosza lampy, 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 teraz tworzy klosz lampy otwarty od spodu, z płytą podstawy pod oprawę źródła światła. Cennik zmienia się wraz z zakresem pracy: prototyp kosztuje 30 kredytów, a budowa 6 kredytów (wcześniej 6 i 30). Parametr text w prototypie został usunięty — wymagany jest image_url.

Sep 2

  • API Animacji akceptuje teraz action_ids — zastosuj do 10 gotowych akcji do postaci z rigiem w jednym żądaniu i otrzymaj pojedynczy plik zawierający jeden klip animacji na każdą akcję, gotowy do sterowania z maszyny stanów w silniku gry. Klipy zachowują kolejność, w jakiej je wymieniono, i noszą nazwę biblioteki danej animacji. Koszt to 3 kredyty za akcję, a post_process dotyczy scalonego pliku. Zobacz dokumentację Biblioteki animacji, aby poznać dostępne identyfikatory, oraz tabelę cen.

Sep 1

  • Dodano parametr ultra_mode do API Wiele obrazów na 3D: umożliwia generowanie Ultra na ai_model meshy-7 (lub latest) dla wyższej wierności geometrii z bardziej szczegółową powierzchnią, za dodatkowe 5 kredytów — ten sam przebieg Ultra, który oferuje API Obraz na 3D, teraz dostępny również dla danych wejściowych typu Wiele widoków.
  • 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. Meshy T1 jest planowany do wycofania — 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: umożliwia programowy eksport historycznych danych o wykorzystaniu zadań API — punkt końcowy, status, znaczniki czasu, klucz API, który uruchomił każde zadanie, oraz consumed_credits — ze standardowym stronicowaniem oraz filtrami przedziału czasu, punktu końcowego i statusu, na potrzeby śledzenia kosztów i systemów finansowych.

Aug 26

  • Animation API obsługuje teraz motion_task_id — pozwala zastosować klip ruchu wygenerowany za pomocą Text to Motion API na Twojej postaci dwunożnej z rigiem, jako alternatywę dla predefiniowanego action_id. Koszt pozostaje taki sam: 3 kredyty za zadanie.

Aug 24

  • Rozszerzono wsparcie aspect_ratio dla gpt-image-2 w API Tekst na obraz oraz Obraz na obraz, dodając 16:9 i 9:16. gpt-image-2 obsługuje teraz 1:1, 16:9, 9:16, 3:2 i 2:3; 4:3 i 3:4 pozostają nieobsł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 szybkiego, ekonomicznego generowania, z klipami o długości 2–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 PNG RGBA z usuniętym tłem.

Aug 18

  • Dodano parametr texture_image_urls do API Wiele obrazów na 3D: podaj od 1 do 4 obrazów tego samego obiektu, aby kierować procesem teksturowania, 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 Text to 3D API: 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 Smart Topology do Text to 3D API. Ustaw model_type: "smart-topology", aby generować za pomocą meshy-t2 — czystsza topology, natywnie oddzielone części, dane wyjściowe 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 4000). 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, zapewniającego geometrię o wyższej wierności niż Meshy 6. Wprowadza on również parametr ultra_mode, który włącza generowanie Ultra pozwalające uzyskać jeszcze dokładniejsze detale powierzchni.
  • Dodano ai_model: "meshy-7" do Multi-Image to 3D API: modelu generowania wielowidokowego Meshy, który bazuje jednocześnie na wszystkich dostarczonych widokach wejściowych i na ich podstawie tworzy teksturowanie.
  • Dodano ai_model: "meshy-7" do Retexture API: naszego najnowszego modelu teksturowania, zapewniającego ostrzejsze detale powierzchni i czystsze materiały PBR niż Meshy 6. Wprowadza on również parametr multiview_image_urls — podaj od 1 do 4 uporządkowanych widoków tego samego obiektu, aby uzyskać teksturowanie wielowidokowe.

Aug 4

  • Rozszerzono obsługę wejścia model_url o .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

  • Nowość: Creative Lab — Brick Figure API: zamień zdjęcie w kolekcjonerską figurkę 3D w stylu klocków. Ten sam dwuetapowy proces co w Figure API — prototype (6 kredytów) generuje stylizowany obraz koncepcyjny, build (30 kredytów) przekształca go w teksturowany model 3D z plikami wyjściowymi GLB i OBJ + MTL. Pełny podział znajdziesz w sekcji Cennik.

Jul 22

  • Nowe Creative Lab — Keycap API: zamień zdjęcie w pełnokolorowy, niestandardowy klawisz do klawiatury mechanicznej. Dwuetapowy proces — prototype (12 kredytów) generuje render gotowego projektu klawisza, a następnie build (50 kredytów) przekształca wybrany projekt (poprzez candidate_id) w teksturowany model 3D klawisza z wynikami w formie pakietu GLB i OBJ, eksportowanego 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 sekcji Cennik.

Jul 21

  • Obsługujemy teraz 8K tekstury koloru bazowego 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 wartości 8k mapy PBR są generowane w rozdzielczości 4K i mapa emisji nie jest tworzona. Generowanie tekstury 8K kosztuje 15 kredytów (2k/4k nadal 10). Zobacz Cennik.
  • Wartość logiczna hd_texture jest przestarzałe na rzecz texture_resolution — nadal jest obsługiwana i, dla zachowania zgodności wstecznej, odpowiada wartości texture_resolution: "4k".

Jul 20

  • Nowość: Creative Lab — Vinyl Figure API: zamień zdjęcie w dużą winylową figurkę kolekcjonerską 3D z dużą głową. Ten sam dwuetapowy proces co w Figure API — prototype (6 kredytów) generuje stylizowany obraz koncepcyjny, build (30 kredytów) zamienia go w teksturowany model 3D z plikami wyjściowymi GLB oraz OBJ + MTL. Pełny podział cen znajdziesz w sekcji Cennik.

Jul 13

  • Dodano nowy model_type Smart Topology 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 oddzielonymi częściami, wyjściem trójkątnym oraz liczbą ścian, którą można ustawić za pomocą target_polycount. meshy-t2 jest domyślny w ramach smart-topology. Dotychczasowy model_type: lowpoly jest teraz przestarzały, ale nadal obsługuje ruch ze względu na kompatybilność wsteczną.

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że być łączony z generate_multi_view.

June 2026

Jun 17

  • Nowa strona dokumentacji API Playground: interaktywna konsola umożliwiająca wypróbowanie endpointów bez pisania kodu, a następnie skopiowanie odpowiedniego kodu cURL, Python 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 — jest to krok niezbędny przed teksturowaniem lub w każdej sytuacji, gdy potrzebujesz czystego, nienachodzącego na siebie układu UV do dalszej pracy w innych narzędziach. Przyjmuje input_task_id (ukoń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 liczbie ścian do 40 000 (w przypadku większych należy najpierw uruchomić Remesh); siatki typu quad i n-gon 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 i kosztuje 30 kredytów. Cennik Prototype pozostaje bez zmian i wynosi 6 kredytów za obraz. Pełne zestawienie znajdziesz w Cennik.

5 cze

Jun 1

  • Nowe Creative Lab APIs: rodzina endpointów przypisanych do konkretnych produktów, które zamieniają zdjęcie źródłowe (lub prompt tekstowy) w produkt konsumencki nadający się do druku 3D. Na start cztery produkty — brelok, magnes na lodówkę, figurka i lampa. Każdy z nich przebiega według dwuetapowego procesu prototype → build, połączonego za pomocą input_task_id, udostępnianego pod adresami URL przypisanymi do danego produktu (/openapi/creative-lab/<product>/v1/...), z osobnym 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

May 26

  • Dodano parametr multi_view_thumbnails do API Wiele obrazów na 3D. Gdy ustawiony na true, zadanie dodatkowo renderuje cztery miniatury z widokami kardynalnymi (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 sekundy do opóźnienia zadania.

May 22

  • Funkcjonalność konwersji i zmiany rozmiaru z Remesh API jest teraz dostępna jako samodzielne endpointy Convert API i Resize API. Przestarzałe parametry w Remesh będą nadal działać w celu zachowania wstecznej kompatybilności.

13 maja

  • Dodano parametr multi_view_thumbnails do API Obraz na 3D. Po ustawieniu wartości true zadanie dodatkowo renderuje cztery miniatury widoków kardynalnych (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 wykonania zadania o około 3 sekundy.

12 maja

  • Dodano parametr resize_longest_side do API Remesh. Zmienia rozmiar modelu tak, aby najdłuższy wymiar bryły ograniczającej (bounding box) był równy podanej wartości w metrach. Parametr ten wyklucza się wzajemnie z resize_height i auto_size.

11 maja

7 maja

  • Nowe API Analizuj drukowalność: Analizuj zakończone powodzeniem zadanie Meshy — lub dowolny adres URL modelu 3D — pod kątem gotowości do druku 3D w technologii FDM. Wzorzec asynchronicznego tworzenia + strumieniowania: żądanie POST zwraca task_id, a następnie żądanie GET / strumień SSE zwracają metryki szczelności, objętości, otworów i krawędzi non-manifold po osiągnięciu statusu SUCCEEDED. Darmowe, nie zużywa kredytów.
  • Nowe API Napraw drukowalność: Napraw model 3D pod kątem drukowalności FDM — usuń 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 odpowiada formatowi wejściowemu. 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 dane zadanie. Pole jest obecne dla zadań o statusach PENDING, IN_PROGRESS i SUCCEEDED. Dla zadań FAILED zwraca 0 (kredyty są automatycznie zwracane w przypadku niepowodzenia). Koszty kredytów dla poszczególnych punktów końcowych znajdziesz w sekcji Cennik.

Apr 24

  • Dodano parametr model_url do punktu końcowego Multi-Color Print. Umożliwia przesłanie modelu 3D z teksturą bezpośrednio (za pomocą adresu URL lub Data URI) zamiast input_task_id z wcześniejszego zadania Meshy. Obsługiwane formaty: .glb, .fbx. Jeśli 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 odwołać się bezpośrednio do wyniku ukończonego zadania Tekst na obraz lub Obraz na obraz zamiast podawania image_url / image_urls. Gdy podano oba, priorytet ma input_task_id.

Apr 20

Apr 14

Apr 12

  • 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 Animation 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 dostępny wyłącznie opcjonalnie i musi zostać jawnie zażądany.
  • Nowe Multi-Color Print API: Konwertuj modele 3D do formatu 3MF wielokolorowego 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. Prosimy o migrację do meshy-6 lub latest.
  • Dodano parametry auto_size oraz 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 zmieniania 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

Luty 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 swoich danych wejściowych. Obsługiwane tylko dla meshy-6 i latest. Domyślna wartość to 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ń. Pomaga to programistom lepiej zrozumieć błędy API i odpowiednio je obsługiwać.

Jan 26

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

22 stycznia

  • Oznaczono jako przestarzałe art_style dla API Podgląd Tekst na 3D (Meshy-6). Parametr został zaprojektowany dla modeli Legacy (Meshy-4 / Meshy-5) i zostanie usunięty w przyszłej wersji.
  • Oznaczono jako przestarzałe enable_pbr dla API Tekst na 3D i 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 i Obraz na 3D. Parametr domyślnie przyjmuje teraz wartość false dla meshy-6 oraz true dla pozostałych modeli, jeśli nie podano inaczej.

Jan 19

Jan 12

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

Grudzień 2025

Dec 31

  • Uruchomiono API Playground, dedykowaną przestrzeń dla deweloperów umożliwiającą eksplorację parametrów API i testowanie żądań bezpośrednio na stronie Meshy.
  • Wprowadzono Text to Image API oraz Image to Image API, umożliwiające generowanie obrazów przy użyciu 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 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

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

Nov 06

  • API Text to 3D Refine obsługuje teraz ai_model = latest, co odpowiada modelowi Meshy 6 Preview.
  • API Obraz na 3D domyślnie korzysta teraz z teksturowania Meshy-6-preview, gdy ai_model = latest oraz should_texture = true.
  • API Wiele obrazów na 3D obsługuje teraz ai_model = latest, domyślnie uruchamiając Meshy-6-preview do teksturowania, podczas gdy generowanie siatki pozostaje oparte na Meshy-5.
  • API Reteksturowanie dodaje opcję latest dla ai_model (Meshy-6-preview) i teraz domyślnie jej używa, gdy parametr zostanie pominięty.

Nov 04

  • Remesh API zachowuje teraz tekstury dla przesłanych modeli.
  • Retexture API 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 bieżącą wersję serwera API.

Oct 20

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

Oct 01

  • Usunięto API text-to-voxel

Wrzesień 2025

Sep 23

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

Sep 18

Sep 16

  • Dodano opcję latest dla ai_model w API Obraz na 3D, aby korzystać z Meshy 6 Preview.

Sep 4

Sierpień 2025

Aug 18

Aug 13

  • Meshy 5 jest teraz stabilny dla Tekst na 3D i 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

10 cze

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

Maj 2025

20 maj

15 maja

Kwiecień 2025

29 kwi

  • 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 i Obraz na 3D. Tag latest teraz również wskazuje na meshy-5.

Apr 17

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

Marzec 2025

Mar 28

  • Dodano parametr latest do interfejsów API Tekst na 3D oraz Obraz na 3D, umożliwiający dostęp do naszych nadchodzących zaawansowanych modeli AI w celu uzyskania lepszej jakości 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 dla 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 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 poprawne żądania wykorzystujące ten klucz zwracają te same przykładowe wyniki zadania.

Feb 13

  • Zmiany istotne (Breaking Changes):

    • Tworzenie zadań w poziomie bezpłatnym zostanie zakończone 20 marca 2025. Po tej dacie wszystkie żądania zadań API będą wymagały płatnej subskrypcji. Aby zapewnić sobie płynny dostęp, zalecamy wykonanie aktualizacji przed tym terminem.
    • Użyj kodu kuponu APIACCESS, aby uzyskać rabat 40%. Dziękujemy, że jesteście Państwo z nami!

  • Dodano endpointy strumieniowania Server-Sent Events (SSE) do aktualizacji zadań w czasie rzeczywistym:

Feb 6

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

January 2025

Jan 23

Jan 14

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

Jan 07

Grudzień 2024

Dec 19

  • Dodano API Remesh, które umożliwiają użytkownikom remeshowanie i eksportowanie istniejących modeli 3D wygenerowanych przez inne API Meshy do różnych formatów.
  • Zaktualizowano limity liczby wielokątów dla naszych API do zakresu 100-300 000 dla użytkowników Premium.

Dec 12

  • Oznaczono parametr model_url jako przestarzałe we wszystkich obiektach odpowiedzi.
  • Oddzielono przestarzałe 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.

November 2024

Nov 14

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