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 aktualny na bieżąco przegląd? Najnowsze wpisy pojawiają się również na stronie przeglądu Developer Platform.

Październik 2026

Oct 15

  • Dodano ai_model: "meshy-t2.5" do interfejsów API Obraz na 3D i Tekst na 3D: najnowszy model Smart Topology, zapewniający ostrzejsze detale dla zasobów do gier. Używaj go z model_type: "smart-topology"; wynikiem jest wyłącznie siatka trójkątna, 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 podania ai_model; ustaw ai_model: "meshy-t2", aby nadal korzystać z Meshy T2. Wiele obrazów na 3D nie obsługuje meshy-t2.5.

Oct 14

  • model_url akceptuje teraz pliki o rozmiarze do 400 MB (zamiast 100 MB), gdy jest to adres URL typu http lub https, w operacjach Retexture, Remesh, Rigging, Convert, Resize, UV Unwrap, Multi-Color Print, Analizuj drukowalność oraz Napraw drukowalność. Adres data: URI nadal jest ograniczony do 100 MB. Plik GLB, glTF, FBX lub OBJ o rozmiarze większym niż 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 zawierający więcej zwraca 400. Powyżej 100 MB plik FBX musi być binarnym 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, dlatego w przypadku dużych plików należy uwzględnić do 120 sekund oczekiwania (zobacz Cykl życia zadania). Pliki o rozmiarze 100 MB lub mniejszym działają tak jak dotychczas, a cennik pozostaje bez zmian.
  • Analizuj drukowalność odpowiada teraz na input_task_id należące do innego konta kodem 404 z taką samą treścią jak w przypadku identyfikatora, który nie istnieje, zamiast kodem 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.

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ą aktualną jednostkę, a pliki USDZ z Riggingu i Animacji nie są objęte tą zmianą.

Oct 10

  • meshy-5 został wycofany. Żądania wysyłające ai_model: "meshy-5" do Text to 3D, Image to 3D, Multi-Image to 3D lub Retexture zwracają teraz 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 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 Image to 3D, Multi-Image to 3D, Image to Image, Retexture (image_style_url) oraz Text to 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 pozostają bez zmian, a cennik się nie zmienia.
  • 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 odświeżeniu. Samo balance pozostaje bez zmian.

Oct 6

  • Analizuj drukowalność i Napraw drukowalność mogą teraz sprawdzać grubość ścianki przy rozmiarze, w jakim planujesz wydruk. Wyślij printer_type, rozmiar wydruku lub oba: analiza zgłasza cienkie ścianki w printability.thin_walls, a naprawa pogrubia je w razie potrzeby i może ponownie wykorzystać drukarkę oraz rozmiar z zadania analizy przekazanego jako input_task_id. Integracje, które nie używają tych pól, działają 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ż parametr 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 odnosi się teraz do 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 obecnie przestarzały ultra_mode (ultra_mode: true nadal działa i jest równoważne "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

  • API Auto Split teraz akceptuje teksturowany input_task_id. Wcześniej odrzucał taki identyfikator z kodem 400, co oznaczało konieczność ponownego wygenerowania tej samej siatki z should_texture: false, aby móc ją podzielić. Zwróć uwagę, co zwraca 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 płaskim kolorem na część — tak było zawsze w przypadku każdego podziału i nic się w tym nie zmieniło.
  • 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 lub Reteksturowanie, 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, użyj Playground w Developer Platform, który uruchamia prawdziwe zadanie w Twojej przeglądarce. W planach bez dostępu do API uruchamia Obraz na 3D bez klucza API i korzysta z kredytów 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 w API Tekst na obraz oraz Obraz na obraz. Są to poziomy modelu 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 oraz 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

  • Image to Image API akceptuje teraz input_task_id — można połączyć się bezpośrednio z ukończonym zadaniem Tekst na obraz lub Obraz na obraz zamiast kopiować jego URL-e wyjściowe do reference_image_urls.

Sep 11

  • Zmiana zachowania: DELETE na zadaniu, 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 worker i odrzucało wynik — zachowując przy tym kredyty, ponieważ tylko zadania PENDING podlegają zwrotowi, więc takie wywołanie kosztowało zarówno model, jak i kredyty, bez żadnej informacji o tym w odpowiedzi. Jeśli Twoja integracja usuwa zadania w celu ich anulowania, pamiętaj, że zadania, które worker już rozpoczął, nie można anulować: 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 każdej rodziny zadań w /openapi. Zobacz Błędy.
  • Dodano meshy-6-lite do udokumentowanych wartości ai_model dla API Text to 3D, Image to 3D, Multi-Image to 3D oraz Retexture. 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 akceptują. Nadal działa i nic nie zmienia się w Twoim żądaniu ani rachunku, ale w przyszłej wersji przestanie akceptować nowy ruch — jeśli Twoja integracja wysyła ai_model: "meshy-5", przejdź na meshy-6-lite.

Sep 9

  • Nowe Auto Split API: Podziel nieoteksturowany model Meshy 6 lub Meshy 7 na części nadające się do osobnego druku — automatycznie, według nazwanych przez Ciebie części (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 w postaci zmontowanej, jak i rozłożonej na płycie 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 budowania automatycznie dziedziczy grawerunek, a obiekt zadania prototypu zwraca teraz name_text, dzięki czemu możesz potwierdzić dokładny tekst przed rozpoczęciem budowania. 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 wielokolorową, drukowaną w 3D planszę typu fidget w stylu pixel-art, w dwóch etapach. POST /prototype (6 kredytów) pikselizuje zdjęcie do postaci obrazu pixel-art — przekaż type jako person lub other, aby wybrać styl pikselizacji — a POST /build (30 kredytów) próbkuje go 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 do druku wielofilamentowego. Geometria elementów jest regulowana 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ą predefiniowaną akcję akceptowaną przez Animation API — action_id, nazwę, kategorię oraz animowany podgląd GIF — wraz z filtrami wyszukiwania i kategorii, dzięki czemu możesz zbudować własny selektor akcji zamiast korzystać z tabeli referencyjnej. Bezpłatne; nie zużywa kredytów.
  • Dodano Creative Lab Collapsible Fidget API: zamienia zdjęcie w składaną zabawkę typu fidget, gotową do druku w jednym kawałku, w której sylwetka obiektu staje się zagnieżdżonymi, współśrodkowymi pierścieniami, dającymi się spłaszczyć i ponownie rozciągnąć, drukowaną jako jeden element bez konieczności montażu. Pojedyncze żądanie POST prowadzi od obrazu 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 zarówno plik STL gotowy do druku, jak i plik GLB do podglądu.

Sep 3

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

Sep 2

  • Animation API akceptuje teraz action_ids — zastosuj do 10 gotowych akcji do riggowanej postaci 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 animacji. Koszt to 3 kredyty za akcję, a post_process dotyczy połączonego pliku. Zobacz Animation Library Reference, 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) w celu uzyskania geometrii o wyższej wierności z dokładniejszymi detalami 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ć właśnie z niej. Meshy T1 jest planowane 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: programowy eksport historycznego wykorzystania 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 czasowego, punktu końcowego i statusu, na potrzeby śledzenia kosztów i systemów finansowych.

Aug 26

  • Animation API akceptuje teraz motion_task_id — pozwala to 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 oraz 2:3; 4:3 i 3:4 nadal nie są obsługiwane dla tego modelu.

Aug 21

  • Dodano Text to Motion API: generowanie klipu 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 czasem trwania klipów 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 koloru 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.

18 sierpnia

  • Dodano parametr texture_image_urls do API Wiele obrazów na 3D: umożliwia podanie 1–4 obrazów tego samego obiektu, które będą 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ą ich liczbę.

17 sierpnia

  • Dodano parametr remove_background do API Tekst na obraz oraz API Obraz na obraz. Ustawienie remove_background: true powoduje, że wygenerowany obraz zostanie zwrócony jako przezroczysty PNG RGBA z usuniętym tłem.

Aug 13

  • Dodano ai_model: "meshy-7" do Tekst na 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 podglądu, który umożliwia 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 Tekst na 3D API. Ustaw model_type: "smart-topology", aby generować za pomocą meshy-t2 — czystszą topology, natywnie oddzielone części, wynik w postaci trójkątów oraz liczbę ścian, którą możesz 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ły, 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 dla jeszcze dokładniejszych szczegółów powierzchni.
  • Dodano ai_model: "meshy-7" do Multi-Image to 3D API: modelu Meshy do generowania wielowidokowego, który bazuje jednocześnie na wszystkich dostarczonych widokach wejściowych i na ich podstawie steruje teksturowaniem.
  • Dodano ai_model: "meshy-7" do Retexture API: naszego najnowszego modelu teksturowania, zapewniającego ostrzejsze szczegóły 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 sterować teksturowaniem wielowidokowym.

Aug 4

  • Rozszerzono obsługę wejścia model_url o formaty .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. Taki sam dwuetapowy proces jak w Figure API — prototype (6 kredytów) generuje stylizowany obraz koncepcyjny, build (30 kredytów) przekształca go w teksturowany model 3D z wynikami w formatach GLB oraz OBJ + MTL. Pełne zestawienie znajdziesz w sekcji Cennik.

Jul 22

  • Nowość Creative Lab — Keycap API: zamień zdjęcie w pełnokolorowy, niestandardowy mechaniczny keycap klawiatury. Dwuetapowy proces — prototype (12 kredytów) generuje render gotowego projektu keycapa, a następnie build (50 kredytów) przekształca wybrany projekt (za pomocą candidate_id) w teksturowany model 3D keycapa z plikami wyjściowymi w pakiecie 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 za pomocą nowego parametru 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 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 kolekcjonerską figurkę 3D w stylu winylowej figurki z dużą głową. 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 oraz OBJ + MTL. Pełne zestawienie cen znajdziesz w sekcji Cennik.

Jul 13

  • Dodano nowy typ model_type o nazwie 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 rozdzielonymi częściami, wyjściem w postaci trójkątów oraz liczbą ścian, którą można ustawić za pomocą target_polycount. meshy-t2 jest modelem domyślnym w ramach smart-topology. Istniejący model_type: lowpoly jest obecnie przestarzałe, 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żesz 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. Opcjonalny; domyślnie 1:1, i nie można go łączyć z generate_multi_view.

June 2026

Jun 17

  • Nowa strona dokumentacji API Playground: interaktywna konsola do testowania endpointów bez pisania kodu, z możliwością skopiowania 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 dla narzędzi końcowych. Przyjmuje albo 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 maksymalnie 40 000 ścian (jeśli siatka jest większa, najpierw uruchom Remesh); siatki czworokątne i n-kątne są triangulowane podczas generowania UV.

Jun 12

  • Zaktualizowano cennik Creative Lab API Build do 30 kredytów za wywołanie dla Keychain, Fridge Magnet oraz Figure (wcześniej 20). Lamp pozostaje bez zmian — 30 kredytów. Cennik dla Prototype pozostaje bez zmian — 6 kredytów za obraz. Pełne zestawienie znajdziesz w sekcji Cennik.

Jun 5

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 gotowy do druku 3D. Na start dostępne są cztery produkty — brelok, magnes na lodówkę, figurka oraz lampa. Każdy z nich realizuje dwuetapowy przepływ pracy prototype → build, połączony za pomocą input_task_id, udostępniany pod adresami URL przypisanymi do danego produktu (/openapi/creative-lab/<product>/v1/...), z wersjonowaniem dla każdego produktu z osobna, 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 w widokach kardynalnych (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 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 zgodności wstecznej.

May 13

  • Dodano parametr multi_view_thumbnails do API Obraz na 3D. Gdy ustawiony na 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 zadania o około 3 sekundy.

May 12

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

11 maja

7 maja

  • Nowe Analizuj drukowalność API: Analizuje 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 i strumieniowania: żądanie POST zwraca task_id, a następnie 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 Napraw drukowalność API: Naprawia model 3D pod kątem drukowalności w technologii FDM — usuwa 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 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. Umożliwia on bezpośrednie odwołanie się do wyniku ukończonego zadania Tekst na obraz lub Obraz na obraz zamiast podawania image_url / image_urls. Gdy podano oba, input_task_id ma priorytet.

Apr 20

Apr 14

Apr 12

  • Zrestrukturyzowano dokumentację API: dodano grupowanie parametrów z polami zależnymi, wartości domyślne w tekście, oznaczenia 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 opcjonalny i musi zostać jawnie zażądany.
  • 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. 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

February 2026

Feb 28

Feb 25

  • Dodano parametr image_enhancement do API Obraz na 3D oraz 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 materiału wejściowego. 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 do Meshy 6.

Jan 22

  • Oznaczono jako przestarzałe art_style dla API Tekst na 3D — podgląd (Meshy-6). Parametr ten został zaprojektowany dla przestarzałych modeli (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, a true dla pozostałych modeli, jeśli nie podano inaczej.

Jan 19

Jan 12

  • Dodano nowy parametr model_type do interfejsu API Image to 3D, umożliwiający generowanie 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 bezpośrednie testowanie zapytań 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 wielu 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 zostały rozszerzone o opcjonalny parametr save_pre_remeshed_model oraz udostępniają model_urls.pre_remeshed_glb, gdy zażądano kopii zapasowej sprzed remesh.

Nov 06

  • Text to 3D Refine API obsługuje teraz ai_model = latest, co odpowiada modelowi 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, 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.

October 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 API text-to-voxel

Wrzesień 2025

Sep 23

  • Dodano opcję latest dla ai_model w API Tekst na 3D, umożliwiającą korzystanie z Meshy 6 Preview.
  • Wprowadzono tymczasową 50% zniżkę 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 parametru ai_model w API Obraz na 3D, umożliwiającą korzystanie z Meshy 6 Preview.

Sep 4

  • Rozszerzono obsługę danych wejściowych model_url o formaty .glb, .gltf, .obj, .fbx, .stl dla Remesh i Reteksturowania.

Sierpień 2025

Aug 18

Aug 13

  • Meshy 5 jest teraz stabilne 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óry umożliwia użytkownikom reteksturowanie modeli 3D w oparciu o najnowsze modele 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.

Maj 2025

May 20

15 maja

Kwiecień 2025

29 kwi

  • Wprowadzono API Wiele obrazów na 3D, umożliwiające generowanie modeli 3D z 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 od 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ąc 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ąc dostęp do naszych nadchodzących zaawansowanych modeli AI w celu poprawy 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: nadal 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 wykorzystujące ten klucz zwrócą te same przykładowe wyniki zadania.

Feb 13

  • Zmiany krytyczne:

    • Tworzenie zadań w poziomie bezpłatnym zakończy się 20 marca 2025. Po tym terminie wszystkie żądania zadań API będą wymagały płatnej subskrypcji. Aby zapewnić sobie płynny 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) do aktualizacji zadań w czasie rzeczywistym:

6 lutego

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

Styczeń 2025

23 stycznia

Jan 14

  • Uznano za przestarzałe starsze 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 na remesh i eksport 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ły we wszystkich obiektach odpowiedzi.
  • Oddzielono starsze (Legacy) API Meshy-3 od najnowszego API Meshy-4.

Dec 10

Dec 5

Dec 3

  • Zewnętrzne API korzystają teraz z prefiksu /openapi. Starsze ś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 base64.