lowpoly bude vyřazen 30. 10. 2026. Před těmito daty přejděte na jiný model, abyste předešli chybám požadavků. Zobrazit všechna ukončení podpory

Changelog

Přehled všech nejnovějších funkcí a aktualizací Meshy API a pluginů.

Preferujete živý přehled? Nejnovější položky se zobrazují také na přehledové stránce Developer Platform.

Listopad 2026

Nov 3

  • Do Obrázek na 3D a Více obrázků na 3D byl přidán parametr texture_model, díky kterému vyberete model textury ve stejné úloze jako síť. Obrázek na 3D přijímá Meshy 7 (meshy-7), Meshy N1 (meshy-n1) a Meshy 6 Lite (meshy-6-lite) s libovolným ai_model. Více obrázků na 3D přijímá modely textur pro více pohledů, Meshy 7 a Meshy N1. Každý model textury má svá vlastní omezení; viz Modely. Úloha stojí cenu samotné sítě podle jejího ai_model plus cenu Retexturování podle rozlišení textury; viz Ceny. Požadavky bez texture_model fungují jako dříve.
  • Do refine fáze Text na 3D byl přidán parametr ai_model: "meshy-n1". Bez texture_image_url texturuje Meshy N1 z referenčního obrázku, který ukládá náhled Meshy 7.1 nebo latest. Ostatní náhledy vyžadují texture_image_url. Refine s Meshy N1 stojí 10 kreditů.

Nov 2

  • Do Retexture API bylo přidáno ai_model: "meshy-n1". Meshy N1 vytváří 2K texturu základní barvy z jednoho až čtyř referenčních obrázků. Při více než jednom obrázku je prvním obrázkem pohled zepředu a pořadí ostatních nezáleží, stejně jako u Meshy 7. Nepřijímá textový prompt, nevytváří PBR mapy ani textury ve 4K a 8K a texturuje 3D modely s maximálně 7 999 999 plochami. Úloha stojí 10 kreditů, stejně jako 2K Retexturování; viz Ceny. latest se stále přiřazuje k Meshy 7.

Říjen 2026

30. října

  • Některé požadavky Meshy T1 (model_type: "lowpoly" nebo ai_model: "meshy-t1") v Text na 3D a Obrázek na 3D nyní běží na Smart Topology, zatímco zbylé vracejí 400. model_type: "smart-topology" s ai_model: "meshy-t2.5" nahrazuje T1. Od 30. listopadu 2026 bude každý požadavek T1 vracet 400. Deprecations obsahuje seznam požadavků, které stále fungují.
  • Auto Split API má nový volitelný parametr keep_texture. S hodnotou keep_texture: true si každá část texturovaného modelu zachová texturu a úloha vrátí mapy textur v texture_urls, spolu se souborem mtl a OBJ. Bez něj funguje rozdělení jako dříve. Rozdělení se zachováním textury trvá přibližně dvakrát déle a stále stojí 10 kreditů. input_task_id nyní také přijímá úlohy Text na 3D refine a Retexturování.

Oct 26

  • Nová stránka Deprecations: životní cyklus každého modelu pro generování 3D (aktivní, legacy, zastaralé nebo vyřazené) spolu s datem vyřazení a doporučenou náhradou, historie veškerého zastarávání API a zastaralé parametry, které jsou stále v provozu. Banner s upozorněním na vyřazení na stránkách API na ni nyní odkazuje.

Oct 23

  • Parametr texture_image_url byl označen jako zastaralé v sekci Rigging. Meshy používá textury vložené v souboru model_url nebo textury vstupní úlohy, takže pokud model má vlastní textury, tento parametr vynechte. Pokud jej odešlete, obrázek se stane jedinou texturou modelu s rigem a model přijde o své PBR mapy.

21. října

  • Přidána hlavička X-Meshy-Metadata pro týmy Studio a Enterprise do každého koncového bodu, který vytváří úlohu, s výjimkou koncových bodů Creative Lab. Označte úlohu vlastními páry klíč-hodnota, například user=alex@example.com,team=fab, a přečtěte si je zpět v poli metadata záznamů Usage. Viz Metadata.

19. října

  • export_resolution nyní přijímá hodnoty až do 512, sníženo z 2048, u build úloh Keychain a Fridge Magnet. 512 je rozlišení hloubkové mapy, ze které je geometrie vytvářena, takže jakákoli hodnota nad tímto limitem vkládala další vrcholy mezi vzorky, které už existovaly, což vedlo k většímu souboru popisujícímu stejný povrch. 512 je zároveň výchozí hodnota, takže volající, kteří nikdy nenastavili export_resolution, nejsou ovlivněni. Hodnota nad 512 nyní při vytváření vrací 400 místo toho, aby byla přijata. 2048 zejména vždy překročila časový limit generátoru a selhala poté, co úloha již byla spuštěna. Pokud máte export_resolution nastaveno nad 512, odeberte tento parametr nebo jej nastavte na 512.

15. října

  • Přidán ai_model: "meshy-t2.5" do API Obrázek na 3D a Text na 3D: nejnovější model Smart Topology s ostřejšími detaily pro herní assety. Používejte jej s model_type: "smart-topology"; výstup obsahuje pouze trojúhelníky a target_polycount přijímá hodnoty od 100 do 30 000 (výchozí je 15 000). Ceny jsou stejné jako u meshy-t2; viz Ceny. Nyní se jedná o výchozí model, pokud je nastaveno model_type: "smart-topology" bez ai_model; pro zachování modelu Meshy T2 nastavte ai_model: "meshy-t2". Více obrázků na 3D nepodporuje meshy-t2.5.

Oct 14

  • model_url nyní přijímá soubory o velikosti až 400 MB, oproti dřívějším 100 MB, pokud se jedná o http nebo https URL, u funkcí Retexturování, Remesh, Rigging, Převést, Změnit velikost, UV rozbalení, Multi-Color Print, Analyzovat tisknutelnost a Opravit tisknutelnost. data: URI zůstává omezeno na 100 MB. Soubor GLB, glTF, FBX nebo OBJ přesahující 100 MB může mít nejvýše 10 000 000 ploch (8 000 000 pro Multi-Color Print), počítaných jako trojúhelníky; soubor s vyšším počtem vrátí 400. Nad 100 MB musí být soubor FBX ve formátu binární FBX 7.1 nebo novější a soubor GLB nebo glTF nesmí používat kompresi Draco. Soubor se stáhne ještě před vrácením odpovědi na požadavek o vytvoření, takže u velkého souboru počítejte až se 120 sekundami (viz Životní cyklus úlohy). Soubory o velikosti 100 MB nebo méně se chovají jako dříve a ceny se nemění.
  • Analyzovat tisknutelnost nyní na input_task_id patřící jinému účtu odpovídá kódem 404 se stejným tělem odpovědi jako u neexistujícího id, místo 403. Úloha patřící vám nebo členovi týmu v pracovním prostoru, do kterého patříte, funguje jako dříve.

12. října

  • Soubory USDZ nyní používají metry, takže se modely otevírají ve skutečné velikosti v AR Quick Look, Reality Composer, Blender a dalších prohlížečích USD. Soubor usdz v model_urls úloh Text na 3D, Obrázek na 3D, Více obrázků na 3D, Retexturování, Remesh, Převést, Změnit velikost a Auto Split nyní deklaruje metersPerUnit = 1. Doposud deklaroval stopy (metersPerUnit = 0.3048), zatímco jeho souřadnice byly v metrech, takže se model zobrazoval na 30,48 % své velikosti. Pokud soubory USDZ kvůli kompenzaci škálujete faktorem 3,28, u úloh vytvořených od tohoto data toto škálování odstraňte. Soubory starších úloh si zachovávají svou aktuální jednotku a soubory USDZ pro Rigging a Animace nejsou dotčeny.

Oct 10

  • meshy-5 byl vyřazen z provozu. Požadavky, které odesílají ai_model: "meshy-5" na Text na 3D, Obrázek na 3D, Více obrázků na 3D nebo Retexturování, nyní vrací 400 se zprávou ai_model meshy-5 has been retired; use meshy-6-lite. Přejděte na meshy-6-lite, který přijímá stejné parametry za stejnou cenu v creditech. Modely, které jste již vygenerovali pomocí meshy-5, zůstávají dostupné a refine náhledu vytvořeného pomocí meshy-5 bez nastavení ai_model stále funguje.
  • .webp je nyní zdokumentován jako podporovaný vstupní formát obrázku, vedle .jpg, .jpeg a .png, u Obrázek na 3D, Více obrázků na 3D, Obrázek na obrázek, Retexturování (image_style_url) a Text na 3D Refine (texture_image_url). Funguje jak pro veřejné URL adresy, tak pro datové URI (data:image/webp;base64,...). Stávající integrace nejsou dotčeny a ceny zůstávají beze změny.
  • Get Balance nyní také vrací monthly_credits, permanent_credits a monthly_resets_at, takže můžete vidět, kolik z vašeho zůstatku vyprší při příští obnově. balance samotný zůstává beze změny.

6. října

  • Analyzovat tisknutelnost a Opravit tisknutelnost nyní dokážou zkontrolovat tloušťku stěny při velikosti, ve které plánujete tisknout. Pošlete printer_type, velikost tisku, nebo obojí. Analýza hlásí tenké stěny v printability.thin_walls a oprava je v případě potřeby zesílí a může znovu použít tiskárnu a velikost z úlohy analýzy předané jako input_task_id. Integrace, které tato pole nepoužívají, se chovají jako dříve, a ceny se nemění.

Září 2026

Sep 29

  • Zastaralá cesta /v2/text-to-3d (bez prefixu /openapi) je zastaralé. Prozatím funguje beze změny dál, ale v budoucí verzi bude odstraněna. Přejděte na /openapi/v2/text-to-3d, která přijímá stejný požadavek a vrací stejnou odpověď. Odpovědi na zastaralé cestě nyní obsahují hlavičku Deprecation a hlavičku Link, která odkazuje na novou cestu.

Sep 28

  • Odpovědi API nyní obsahují hlavičky limitu rychlosti, včetně Retry-After, která udává, jak dlouho čekat před dalším pokusem nebo dotazováním.
  • Multi-Color Print nyní přijímá nový parametr printer_brand, který zapíše odpovídající přednastavení slicer do 3MF, takže se soubor otevře připravený k tisku na tiskárnách Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker a AnkerMake, stejně jako na Bambu Lab (výchozí volba). Stránka nyní také popisuje max_depth.

Sep 18

  • Byla přidána hodnota meshy-7.1 jako hodnota ai_model pro Obrázek na 3D, Více obrázků na 3D a Text na 3D: stejné parametry a stejná cena v kreditech jako meshy-7, vyšší detail geometrie. latest nyní odkazuje na meshy-7.1; meshy-7 je zastaralé, ale nadále funguje beze změny.
  • Do stejných API byl přidán parametr geometry_resolution (standard / 2k / 4k), který nahrazuje nyní zastaralý parametr ultra_mode (ultra_mode: true stále funguje a odpovídá hodnotě "2k"). 4k vyžaduje Meshy 7.1 (meshy-7.1 nebo latest), není dostupné pro Více obrázků na 3D a stojí stejných 5 kreditů navíc jako 2k.

16. září

  • Auto Split API nyní přijímá texturovaný input_task_id. Dříve jej odmítalo s chybou 400, což znamenalo, že bylo nutné vygenerovat stejnou síť podruhé s should_texture: false, aby bylo možné ji rozdělit. Rozdělení rozřízne geometrii a znovu vytvoří povrchy jednotlivých částí, takže textura vstupu se nepřenáší a výsledkem je model bez textury, kde má každá část jednu jednolitou barvu. To platilo již pro každé dělení a zůstává to beze změny.
  • meshy-5 bude vyřazeno 10. října 2026. Již není uvedeno jako dokumentovaná hodnota ai_model pro Text na 3D, Obrázek na 3D, Více obrázků na 3D nebo Retexturování, a po 10. říjnu budou požadavky, které odešlou ai_model: "meshy-5", vracet chybu.
  • Sdílený testovací API klíč byl vyřazen; požadavky, které jej stále odesílají, nyní vrací 401 Unauthorized. Pokud jste jej zkopírovali do kódu nebo CI, nahraďte jej vlastním klíčem ze stránky API klíčů. Tento klíč vždy vracel stejný ukázkový model bez ohledu na vstup, takže nikdy neukazoval, co by daný požadavek skutečně vygeneroval. Chcete-li zjistit, co API vrátí ještě předtím, než na něm začnete stavět, použijte Playground v Developer Platform, který spustí skutečnou úlohu přímo ve vašem prohlížeči. U plánů bez přístupu k API spouští Obrázek na 3D bez API klíče a využívá kredity vašeho účtu stejně jako jakákoli jiná úloha.

Sep 15

  • Do dokumentovaných hodnot ai_model pro API Text na obrázek a Obrázek na obrázek byly přidány gpt-image-2-5-flare a gpt-image-2-5-sunburst. Jedná se o úrovně OpenAI GPT Image 2.5, jejichž cena je stejná jako u gpt-image-2 (Text na obrázek: 9 kreditů; Obrázek na obrázek: 12 kreditů).
  • Modely GPT Image (gpt-image-2, gpt-image-2-5-flare, gpt-image-2-5-sunburst) nyní v API Text na obrázek a Obrázek na obrázek podporují i poměry stran 4:3 a 3:4, kromě 1:1, 16:9, 9:16, 3:2 a 2:3.

Sep 14

  • Image to Image API nyní přijímá input_task_id, takže můžete navázat přímo na dokončenou úlohu Text na obrázek nebo Obrázek na obrázek, místo kopírování výstupních URL adres do reference_image_urls.

Sep 11

  • Změna chování: DELETE u úlohy, která je již ve stavu IN_PROGRESS, je nyní odmítnuto s chybou 409 Conflict, a úloha zůstává spuštěná. Dříve to vrátilo 200 OK, zastavilo worker a zahodilo výsledek, ale kredity si ponechalo, protože vratné jsou pouze úlohy ve stavu PENDING. Volání vás tak stálo model i kredity, aniž by to odpověď jakkoli naznačovala. Pokud vaše integrace maže úlohy za účelem jejich zrušení, mějte na paměti, že úlohu, kterou worker již začal zpracovávat, nelze zrušit. Počkejte na stav SUCCEEDED, FAILED nebo CANCELED a poté ji smažte. Úlohy ve stavu PENDING se stále mažou a vracejí přesně jako dříve a úlohy v koncovém stavu se stále mažou. Platí pro všechny rodiny úloh pod /openapi. Viz Chyby.
  • Do dokumentovaných hodnot ai_model pro API Text na 3D, Obrázek na 3D, Více obrázků na 3D a Retexturování byl přidán meshy-6-lite. Jedná se o nástupce meshy-5: stejné parametry, stejná cena v kreditech (5 za síť, 15 s texturou, 10 za retexturování).
  • meshy-5 je nyní zastaralé napříč všemi API, která jej přijímají. Stále funguje a na vašem požadavku ani vyúčtování se nic nemění, ale v budoucí verzi přestane přijímat nový provoz. Pokud vaše integrace odesílá ai_model: "meshy-5", přejděte na meshy-6-lite.

9. září

  • Nové Auto Split API: Rozdělí netexturovaný model Meshy 6 nebo Meshy 7 na samostatně tisknutelné díly. Dělení probíhá automaticky, podle vámi pojmenovaných dílů (by_parts), nebo podle barevných oblastí (by_color), s volitelnými spoji na pero a drážku a zesílením tenkých stěn. Export každého dílu jako samostatného objektu ve formátu glb, obj, fbx, usdz, blend nebo 3mf, buď sestavené, nebo rozmístěné na tiskové podložce (layout). 10 kreditů za úlohu.

7. září

  • Přidán parametr name_text do fáze prototypu Creative Lab Keychain API: umožňuje vyrýt na klíčenku jméno o délce až 10 znaků, stejnou personalizaci, jakou nabízí webová aplikace. Fáze sestavení rytinu automaticky přebírá a objekt úlohy prototypu nyní vrací name_text, abyste si mohli potvrdit přesný text před sestavením. name zůstává pouze zobrazovaným popiskem úlohy a není vyryto.

5. zář

  • Přidáno Creative Lab Fidget Pixel API: proměňte fotografii na vícebarevnou fidget desku s pixel-art designem, vytisknutelnou na 3D tiskárně, ve dvou fázích. POST /prototype (6 kreditů) převede fotografii na pixel-art obrázek. Pomocí parametru type nastaveného na person nebo other zvolte styl pixelizace. POST /build (30 kreditů) jej vzorkuje na mřížku 16 nebo 32 a každý pixel přemění na zapadající díl ve tvaru square nebo hex, dodaný jako jediný 3MF soubor s barevným označením pro tisk s více filamenty. Geometrie dílu je nastavitelná pomocí piece_size_mm, color_count a piece_height_mm.

Sep 4

  • Přidán GET /openapi/v1/animations/library do Knihovny animací: umožňuje načíst všechny přednastavené akce, které Animation API přijímá (action_id, název, kategorie a náhled v podobě animovaného GIFu), s možností filtrování podle vyhledávání a kategorie, takže si místo studování referenční tabulky můžete vytvořit vlastní výběr akcí. Je zdarma a nespotřebovává žádné kredity.
  • Přidáno Creative Lab Collapsible Fidget API: promění fotografii ve skládací fidget hračku tisknutelnou na místě, kde se silueta objektu přemění na vnořené soustředné kruhy, které se dají stlačit naplocho a znovu roztáhnout, vytištěné jako jeden celek bez nutnosti skládání. Jediný POST provede obrázek celým procesem až k hotovému modelu. Neexistuje žádná dvojice fází prototyp/sestavení ani žádné parametry geometrie k ladění. Každá úloha stojí 6 kreditů a vrací tisknutelný soubor STL, případně i GLB pro náhled, pokud ho Meshy dokáže vykreslit.

Sep 3

  • Fáze prototypu Creative Lab Lamp API nyní vrací 3D model. POST /prototype převede koncepční obrázek na dutý GLB stínidla lampy a objekt úlohy prototypu nově obsahuje model_urls.glb a thumbnail_url vedle image_urls. Fáze sestavení spouští na tomto modelu pouze procesor pro lampy a nyní vytváří stínidlo s otevřeným dnem a základní deskou pro upevnění světelného zdroje. Ceny se mění podle rozsahu práce. Prototyp stojí 30 kreditů a sestavení 6 kreditů (dříve 6 a 30). Parametr text u prototypu byl odstraněn a image_url je nyní povinný.

Sep 2

  • Animation API nyní přijímá action_ids, takže můžete na jednu postavu s rigem v jednom požadavku aplikovat až 10 předvolených akcí a získat jediný soubor obsahující jeden animační klip pro každou akci, připravený k ovládání ze stavového automatu v herním enginu. Klipy si zachovávají pořadí, v jakém jste je uvedli, a nesou název knihovny dané animace. Stojí 3 kredity za akci a post_process se vztahuje na sloučený soubor. Dostupná id najdete v referenční příručce Knihovna animací a ceny v tabulce cen.

1. září

  • Do API pro Více obrázků na 3D byl přidán parametr ultra_mode: umožňuje spuštění Ultra generování na ai_model meshy-7 (nebo latest) pro geometrii s vyšší věrností a jemnějšími detaily povrchu, za 5 kreditů navíc. Jde o stejný Ultra průchod, jaký nabízí API pro Obrázek na 3D, nyní dostupný i se vstupy z více pohledů.
  • Z dokumentovaných hodnot ai_model pro model_type Smart Topology v API pro Obrázek na 3D byl odstraněn meshy-t1. Smart Topology nyní dokumentuje pouze meshy-t2; nové integrace by měly používat jej. Meshy T1 je plánováno k ukončení podpory. Pokud vaše integrace aktuálně odesílá ai_model: "meshy-t1", přejděte na meshy-t2.

Srpen 2026

Aug 28

  • Přidáno Usage API pro týmy Studio a Enterprise: programově exportujte historické údaje o využití API úloh (koncový bod, stav, časová razítka, API klíč, který úlohu spustil, a consumed_credits) se standardním stránkováním a filtry podle časového okna, koncového bodu a stavu, pro sledování nákladů a finanční systémy.

Aug 26

  • Animation API nyní přijímá motion_task_id, takže můžete na vaši riggovanou postavu s dvěma končetinami aplikovat pohybový klip vygenerovaný pomocí Text to Motion API jako alternativu k přednastavenému action_id. Stejná cena 3 kredity za úlohu.

Aug 24

  • Rozšířena podpora aspect_ratio pro gpt-image-2 v API Text na obrázek a Obrázek na obrázek, přidány poměry 16:9 a 9:16. gpt-image-2 nyní podporuje 1:1, 16:9, 9:16, 3:2 a 2:3; 4:3 a 3:4 zůstávají pro tento model nepodporované.

Aug 21

  • Přidáno Text to Motion API: vygenerujte animační klip pohybu postavy z popisu v přirozeném jazyce, bez nutnosti modelu postavy. Zvolte prime mode (10 kreditů, výstup ve formátu FBX) pro nejvyšší kvalitu nebo swift mode (3 kredity, výstup ve formátu BVH) pro rychlé a úsporné generování, s délkou klipu od 2 do 10 sekund.

Aug 20

  • Do Multi-Color Print API byl přidán parametr style: zvolte realistic (výchozí), pro barvy odpovídající textuře, nebo cartoon pro ploché, jednolité barevné oblasti a menší soubor 3MF.
  • Do každého koncového bodu prototypů Creative Lab byl přidán parametr remove_background: Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet a Lamp. Nastavením remove_background: true obdržíte obrázek prototypu jako transparentní RGBA PNG s odstraněným pozadím.

Aug 18

  • Do Více obrázků na 3D API byl přidán parametr texture_image_urls: poskytněte 1 až 4 obrázky stejného objektu pro řízení texturování, místo jediné hodnoty texture_image_url. Vyžaduje ai_model meshy-7 nebo latest a je nezávislý na image_urls. Oba seznamy mohou obsahovat odlišné obrázky a odlišný počet obrázků.

Aug 17

Aug 13

  • Do Text na 3D API byl přidán ai_model: "meshy-7": náš nejnovější model pro generování 3D, s vyšší věrností geometrie než Meshy 6. Zároveň zavádí parametr ultra_mode v rámci preview úlohy, který umožňuje Ultra generování pro ještě jemnější detaily povrchu za 5 kreditů navíc. Pro texturování pomocí Meshy 7 předejte ai_model: "meshy-7" v refine úloze, nebo ai_model zcela vynechte.
  • Do Text na 3D API byl přidán model_type Smart Topology. Nastavením model_type: "smart-topology" generujete pomocí meshy-t2: čistší topology, nativně oddělené části, výstup v trojúhelnících a počet ploch, který lze nastavit pomocí target_polycount (100 až 15 000, výchozí hodnota 4 000). Náhled Smart Topology stojí 5 kreditů místo 20; viz Ceny. Stávající model_type: "lowpoly" je nyní zastaralé, ale kvůli zpětné kompatibilitě je nadále v provozu.

Aug 12

  • Přidán ai_model: "meshy-7" do Image to 3D API: náš nejnovější model pro generování 3D, s vyšší věrností geometrie než Meshy 6. Zavádí také parametr ultra_mode, který umožňuje generování v režimu Ultra pro ještě jemnější detaily povrchu.
  • Přidán ai_model: "meshy-7" do Multi-Image to 3D API: model Meshy pro generování z více pohledů, který vychází ze všech vašich vstupních pohledů společně a podle nich řídí texturování.
  • Přidán ai_model: "meshy-7" do Retexture API: náš nejnovější model pro texturování, s ostřejšími detaily povrchu a čistšími PBR materiály než Meshy 6. Zavádí také parametr multiview_image_urls. Poskytněte 1 až 4 seřazené pohledy stejného objektu pro řízení texturování z více pohledů.

Aug 4

  • Rozšířena podpora vstupu model_url o .glb, .gltf, .obj, .fbx, .stl pro endpointy Analyzovat tisknutelnost a Opravit tisknutelnost (dříve .glb, .stl, .obj). Oprava vrací opravený asset ve stejném formátu, v jakém byl vstup.

Červenec 2026

Jul 27

  • Nové Creative Lab Brick Figurka API: promění fotografii ve sběratelskou 3D minifigurku ve stylu stavebnice z kostek. Používá stejný dvoufázový postup jako Figurka API. prototype (6 kreditů) vygeneruje stylizovaný koncepční obrázek a build (30 kreditů) jej promění v texturovaný 3D model s výstupy GLB a OBJ + MTL. Úplný přehled najdete v sekci Ceny.

Jul 22

  • Nové Creative Lab Keycap API: proměňte fotografii v plnobarevnou vlastní klávesu mechanické klávesnice. Používá dvoufázový pracovní postup. prototype (12 kreditů) vygeneruje render hotového designu klávesy, poté build (50 kreditů) převede vybraný design (pomocí candidate_id) na texturovaný 3D model klávesy s výstupy GLB a OBJ v jednom balíčku, exportovaný v reálném měřítku v milimetrech. Aktuálně podporuje standardní základnu Cherry MX 1u (cherry-mx-1x1-r1); další standardní velikosti jsou plánovány. Úplný přehled najdete v sekci Ceny.

Jul 21

  • Nyní podporujeme 8K textury základní barvy prostřednictvím nového parametru texture_resolution (2k / 4k / 8k) na endpointech Obrázek na 3D, Více obrázků na 3D, Text na 3D Refine a Retexturování. Při 8k jsou PBR mapy generovány ve 4K a nevytváří se žádná emisní mapa. Generování 8K textury stojí 15 kreditů (2k/4k zůstávají 10). Viz Ceny.
  • Booleovský parametr hd_texture je zastaralé ve prospěch texture_resolution. Je stále respektován a pro zpětnou kompatibilitu odpovídá hodnotě texture_resolution: "4k".

Jul 20

  • Nové Creative Lab Vinyl Figure API: proměňte fotografii ve velkohlavou vinylovou sběratelskou 3D figurku. Používá stejný dvoufázový postup jako Figure API. prototype (6 kreditů) vygeneruje stylizovaný koncepční obrázek a build (30 kreditů) jej přemění na texturovaný 3D model s výstupy GLB a OBJ + MTL. Úplný přehled naleznete v Ceny.

Jul 13

  • Do API Obrázek na 3D byl přidán nový model_type Smart Topology, který nabízí dva modely prostřednictvím ai_model: meshy-t1 (současný low-poly model) a meshy-t2 (nový model s čistší topology, nativně oddělenými částmi, trojúhelníkovým výstupem a počtem polygonů, který lze nastavit pomocí target_polycount). meshy-t2 je výchozí volbou pod smart-topology. Stávající model_type: lowpoly je nyní zastaralé, ale kvůli zpětné kompatibilitě je nadále funkční.

Jul 7

  • Do parametru Image to Image API byl přidán parametr aspect_ratio, díky kterému můžete při úpravách ovládat poměr stran výstupního obrázku. Povolené hodnoty jsou 1:1, 16:9, 9:16, 4:3, 3:4 pro modely nano-banana a 1:1, 3:2, 2:3 pro gpt-image-2. Volitelný parametr; výchozí hodnota je 1:1 a nelze jej kombinovat s generate_multi_view.

Červen 2026

Jun 17

  • Nová stránka dokumentace API Playground: interaktivní konzole pro vyzkoušení endpointů bez psaní kódu, s možností následného zkopírování odpovídajícího kódu v cURL, Pythonu nebo JavaScriptu. Dostupné v plánech Pro, Premium, Ultra, Studio a Enterprise.

15. června

  • Nové UV Unwrap API: vygeneruje vysoce kvalitní UV rozvržení pro existující 3D model (předpoklad pro texturování, nebo kdykoliv potřebujete čisté, nepřekrývající se UV rozvržení pro navazující nástroje). Přijímá buď input_task_id (dokončenou úlohu Obrázek na 3D, Text na 3D nebo Remesh), nebo model_url (pouze .glb) a vrací „UV bílý model“ s úplně novými UV souřadnicemi. 5 kreditů za volání. Podporuje sítě s až 40 000 plochami (pokud je síť větší, nejprve spusťte Remesh); čtyřúhelníkové a n-úhelníkové sítě jsou při generování UV triangulovány.

12. června

  • Aktualizovány ceny Creative Lab API Build na 30 kreditů za volání pro Klíčenka, magnet na lednici a figurka (dříve 20). Lampa zůstává beze změny na 30 kreditech. Ceny Prototype zůstávají beze změny na 6 kreditech za obrázek. Úplný přehled naleznete v sekci Ceny.

5. června

1. červen

  • Nové Creative Lab APIs: rodina endpointů s rozsahem na konkrétní produkt, které promění zdrojovou fotografii (nebo textový prompt) ve spotřební produkt připravený k 3D tisku. Při spuštění čtyři produkty: Keychain, Fridge Magnet, Figure a Lamp. Každý z nich se řídí dvoufázovým workflow prototype → build propojeným přes input_task_id a je dostupný pod URL adresami s rozsahem na konkrétní produkt (/openapi/creative-lab/<product>/v1/...) s verzováním pro jednotlivé produkty, takže se produkty mohou vyvíjet na nezávislých verzovacích liniích. Prototype: 6 kreditů za volání. Build: 30 kreditů za volání.

Květen 2026

May 26

  • Do API Více obrázků na 3D byl přidán parametr multi_view_thumbnails. Pokud je nastaven na true, úloha navíc vykreslí čtyři pohledy ze světových stran (zepředu, zprava, zezadu, zleva) a vrátí je v novém poli odpovědi thumbnail_urls. Stávající pole thumbnail_url zůstává beze změny. Tato funkce prodlouží latenci úlohy přibližně o 3 sekundy.

May 22

  • Funkce pro převod a změnu velikosti z Remesh API jsou nyní dostupné jako samostatné endpointy Convert API a Resize API. Zastaralé parametry v Remesh budou nadále fungovat kvůli zpětné kompatibilitě.

13. května

  • Do API Obrázek na 3D byl přidán parametr multi_view_thumbnails. Pokud je nastaven na true, úloha navíc vykreslí čtyři náhledy ze základních pohledů (zepředu, zprava, zezadu, zleva) a vrátí je v novém poli odpovědi thumbnail_urls. Stávající pole thumbnail_url zůstává beze změny. Přidává k latenci úlohy přibližně 3 sekundy.

12. května

  • Do API Remesh byl přidán parametr resize_longest_side. Změní velikost modelu tak, aby nejdelší rozměr ohraničujícího boxu odpovídal zadané hodnotě v metrech. Vzájemně se vylučuje s resize_height a auto_size.

11. května

7. května

  • Nové Analyze Printability API: Analyzovat tisknutelnost úspěšné úlohy Meshy nebo libovolné URL 3D modelu z hlediska připravenosti na FDM 3D tisk. Asynchronní vzor vytvoření + streamování: POST vrátí task_id, poté GET / SSE stream vrátí po úspěšném dokončení (SUCCEEDED) metriky vodotěsnosti, objemu, otvorů a non-manifold hran. Zdarma, nespotřebovává kredity.
  • Nové Repair Printability API: Opravit tisknutelnost 3D modelu pro FDM tisk, oprava non-manifold hran, degenerovaných ploch, otvorů a dalších problémů s topology. Přijímá existující input_task_id z Meshy nebo model_url (.glb, .stl, .obj). Výstupní formát odpovídá vstupnímu. 10 kreditů za úlohu.

Duben 2026

Apr 27

  • Přidáno pole consumed_credits do všech odpovědí úloh napříč všemi koncovými body API. Zobrazuje počet kreditů spotřebovaných danou úlohou. Toto pole je přítomné u úloh ve stavech PENDING, IN_PROGRESS a SUCCEEDED. U úloh ve stavu FAILED vrací 0 (kredity jsou v případě selhání automaticky vráceny). Náklady na kredity pro jednotlivé koncové body naleznete v sekci Ceny.

Apr 24

  • Do koncového bodu Multi-Color Print byl přidán parametr model_url. Umožňuje odeslat texturovaný 3D model přímo (pomocí URL nebo Data URI) namísto input_task_id z předchozí úlohy Meshy. Podporované formáty: .glb, .fbx. Pokud jsou zadány oba parametry, model_url i input_task_id, má přednost input_task_id.

21. dubna

  • Do endpointů Obrázek na 3D a Více obrázků na 3D byl přidán parametr input_task_id. Umožňuje přímo odkázat na výstup dokončené úlohy Text na obrázek nebo Obrázek na obrázek místo zadávání image_url / image_urls. Pokud jsou zadány oba, má přednost input_task_id.

20. dubna

14. dubna

12. dubna

  • Restrukturalizována API dokumentace: přidáno seskupování parametrů se závislými poli, vloženými výchozími hodnotami, štítky povinné/zastaralé, rozbalitelná dílčí navigace a rozdělení Multi-Image, Rigging a Animace do samostatných stránek.

Březen 2026

Apr 2

  • Přidána podpora formátu 3mf do parametru target_formats napříč všemi endpointy (Obrázek na 3D, Text na 3D, Remesh, Retexturování). Poznámka: 3MF je dostupné pouze na vyžádání a musí být výslovně požadováno.
  • Nové Multi-Color Print API: Převést 3D modely do vícebarevného formátu 3MF pro 3D tisk. Podporuje palety 1 až 16 barev s nastavitelnou přesností. 10 kreditů za úlohu.

20. března

  • Byl ukončen provoz AI modelu Meshy-4. Všechny API požadavky používající meshy-4 již nejsou podporovány. Přejděte na meshy-6 nebo latest.
  • Do endpointů Obrázek na 3D, Více obrázků na 3D, Text na 3D a Remesh byly přidány parametry auto_size a origin_at. Když je auto_size povoleno, služba pomocí AI vidění odhadne skutečnou výšku a model automaticky změní velikost. origin_at nastavuje pozici počátku (bottom nebo center). V API pro Remesh se auto_size vzájemně vylučuje s resize_height.

Mar 17

Únor 2026

Feb 28

Feb 25

  • Přidán parametr image_enhancement do API Obrázek na 3D a Více obrázků na 3D pro uživatele, kteří chtějí odmítnout optimalizaci vstupního obrázku a zachovat přesný vzhled svého vstupu. Podporováno pouze pro meshy-6 a latest. Výchozí hodnota je true.

Feb 20

  • Přidán parametr model_type do API Text na 3D Preview pro generování low-poly sítí optimalizovaných pro čistší polygony.

Leden 2026

27. ledna

  • Byla přidána podrobná dokumentace Failure Modes pro všechny API endpointy, včetně běžných kódů HTTP chyb (400, 401, 402, 404, 422, 429) a důvodů selhání úloh. To vývojářům pomáhá lépe porozumět chybám API a lépe je zpracovávat.

26. ledna

  • API Více obrázků na 3D nyní podporuje Meshy-6 pro plnohodnotné generování sítě. Parametr ai_model nyní přijímá hodnotu meshy-6 a hodnota latest se nyní překládá na Meshy 6.

Jan 22

  • Zastaralý parametr art_style pro API Text na 3D Preview (Meshy-6). Tento parametr byl navržen pro zastaralé modely (Meshy-4 / Meshy-5) a bude v budoucí verzi odstraněn.
  • Zastaralý parametr enable_pbr pro API Text na 3D a Obrázek na 3D, pokud je ai_model nastaveno na meshy-4. Tento parametr bude v budoucí verzi odstraněn.
  • Aktualizována výchozí hodnota parametru should_remesh pro Meshy-6 v API Text na 3D a Obrázek na 3D. Pokud není parametr zadán, nyní pro meshy-6 implicitně nastaví hodnotu false a pro ostatní modely hodnotu true.

19. ledna

12. ledna

  • Do API Obrázek na 3D byl přidán nový parametr model_type pro generování low-poly sítí optimalizovaných pro čistší polygony.

Prosinec 2025

31. prosince

  • Spuštěn API Playground, vyhrazený prostor pro vývojáře k prozkoumávání parametrů API a testování požadavků přímo na webu Meshy.
  • Představeny Text to Image API a Image to Image API, umožňující generování obrázků pomocí AI z textových promptů a úpravu obrázků na základě referenčních obrázků. Obě API podporují modely nano-banana a nano-banana-pro, s volitelným generováním více pohledů.

22. prosince

  • Pole video_url v odpovědi API Text na 3D je nyní zastaralé a bude v budoucí verzi odstraněno.

4. prosince

Listopad 2025

Nov 24

  • API Obrázek na 3D a Více obrázků na 3D nyní přidávají volitelný parametr save_pre_remeshed_model a zpřístupňují model_urls.pre_remeshed_glb, pokud je vyžádána záloha před remeshem.

Nov 06

  • API Text na 3D Refine nyní podporuje ai_model = latest, které se překládá na Meshy 6 Preview.
  • API Obrázek na 3D nyní standardně používá texturování Meshy-6-preview, pokud je ai_model = latest a should_texture = true.
  • API Více obrázků na 3D nyní podporuje ai_model = latest, přičemž pro texturování se standardně používá Meshy-6-preview, zatímco generování sítě zůstává Meshy-5.
  • API Retexturování přidává pro ai_model možnost latest (Meshy-6-preview) a nyní ji v případě vynechání používá jako výchozí.

Nov 04

  • Remesh API nyní zachovává textury u nahraných modelů.
  • Retexture API nyní zachovává textury u nahraných modelů, pokud je povolena možnost enable_original_uv.

Říjen 2025

Oct 28

  • Přidána hlavička odpovědi x-api-version indikující aktuální verzi API serveru.

Oct 20

  • Přidán volitelný booleovský parametr convert_format_only do Remesh API, který umožňuje provést pouze konverzi formátu vstupního souboru modelu.
  • Přidáno rigged_character_glb_url do odpovědi The Rigging Task Object.

Oct 01

  • Odebrání API text-to-voxel

Září 2025

Sep 23

  • Přidána možnost latest pro ai_model v API Text na 3D pro použití Meshy 6 Preview.
  • Dočasná 50% sleva na generovací úlohy Meshy-6-preview na 10 kreditů, která bude platit do 30. září 2025. Po skončení slevového období se cena úloh Meshy-6-preview vrátí na běžných 20 kreditů.

Sep 18

16. zář.

  • Přidána možnost latest pro ai_model v API Obrázek na 3D pro použití Meshy 6 Preview.

4. zář.

  • Rozšířena podpora vstupu model_url o formáty .glb, .gltf, .obj, .fbx, .stl pro Remesh a Retexturování.

Srpen 2025

18. srp.

Aug 13

  • Meshy 5 je nyní stabilní pro Text na 3D a Obrázek na 3D (ai_model: meshy-5), s vylepšenou kvalitou a konzistencí.

Červenec 2025

Jul 31

Červen 2025

Jun 25

  • Přidáno Retexture API, které umožňuje uživatelům retexturovat 3D modely na základě nejnovějších základních AI modelů Meshy.

Jun 19

Jun 17

10. června

  • Remesh API nyní podporuje modely GLB kódované pomocí base64 v parametru model_url prostřednictvím Data URI.

Květen 2025

20. května

15. května

  • Byla zavedena služba Auto-rigging & Animation API, která uživatelům umožňuje automaticky vytvořit rig a animaci 3D modelů. Zjistěte více o riggingu a Animaci.

Duben 2025

29. dubna

  • Bylo zavedeno Multi-Image to 3D API, které umožňuje generování 3D modelů z 1 až 4 vstupních obrázků pomocí AI modelu meshy-5.
  • Do API Text na 3D a Obrázek na 3D byla přidána možnost AI modelu meshy-5. Značka latest nyní také odkazuje na meshy-5.

17. dubna

  • Do API Obrázek na 3D a Text na 3D Refine byl přidán parametr texture_image_url, který uživatelům umožňuje řídit proces generování textury pomocí obrázku.

Březen 2025

28. března

  • Do API Text na 3D a Obrázek na 3D byl přidán parametr latest, který umožňuje přístup k našim připravovaným pokročilým AI modelům pro zlepšenou kvalitu generování.

14. března

6. března

  • Aktualizované ceny pro API generovací úlohy:
    • Text na 3D (Preview): Zvýšeno z 2 na 5 kreditů za volání
    • Text na 3D (Refine): Zvýšeno z 5 na 10 kreditů za volání
    • Obrázek na 3D: Nyní 5 kreditů bez textury, 15 kreditů s texturou
    • Text na texturu: Zvýšeno z 5 na 10 kreditů za volání
    • Text to Voxel: Zůstává na 5 kreditech za volání

Únor 2025

Feb 18

  • Přidán API klíč testovacího režimu, který vývojářům umožňuje testovat integraci API bez spotřeby kreditů. Všechny platné požadavky s tímto klíčem vrátí stejné ukázkové výsledky úkolu.

Feb 13

  • Zásadní změny:

    • Vytváření úkolů v rámci bezplatné úrovně skončí 20. března 2025. Poté budou všechny požadavky na úkoly API vyžadovat placené předplatné. Abyste zajistili plynulý přístup, doporučujeme upgradovat před tímto termínem.
    • Použijte kód kupónu APIACCESS a získejte slevu 40%. Děkujeme, že jste s námi!

  • Přidány endpointy pro streamování pomocí Server-Sent Events (SSE) pro aktualizace úkolů v reálném čase:

Feb 6

  • Do API Obrázek na 3D a Text na 3D Refine byl přidán parametr texture_prompt, který uživatelům umožňuje ovlivnit proces generování textury pomocí textového promptu.

Leden 2025

Jan 23

Jan 14

  • Zastaralé staré API pro Text na 3D a Obrázek na 3D poháněné AI modely Meshy-3.

Jan 07

December 2024

Dec 19

  • Přidána Remesh API, která uživatelům umožňuje provádět remesh a exportovat existující 3D modely vygenerované jinými API Meshy do různých formátů.
  • Aktualizovány limity počtu polygonů pro naše API na rozsah 100 až 300 000 pro Premium uživatele.

12. prosince

  • Zastaralá vlastnost model_url byla označena jako zastaralá ve všech objektech odpovědi.
  • Legacy Meshy-3 API bylo odděleno od nejnovějšího Meshy-4 API.

10. prosince

Dec 5

Dec 3

  • Externí API nyní používají prefix /openapi. Starší (Legacy) cesty jsou nadále podporovány, ale doporučujeme přejít na nové cesty.

Listopad 2024

Nov 14

  • API Obrázek na 3D nyní podporuje obrázky kódované ve formátu base64.