Changelog
Podívejte se na všechny nejnovější funkce a aktualizace Meshy API a pluginů.
Preferujete živý přehled? Nejnovější záznamy se také zobrazují na přehledové stránce Developer Platform.
Říjen 2026
Oct 15
- Do API Obrázek na 3D a Text na 3D byl přidán
ai_model: "meshy-t2.5": nejnovější model Smart Topology s ostřejšími detaily pro herní assety. Používejte jej smodel_type: "smart-topology"; výstup je pouze trojúhelníkový atarget_polycountpřijímá hodnoty od 100 do 30 000 (výchozí hodnota 15 000). Ceny jsou stejné jako umeshy-t2; viz Ceny. Nyní se jedná o výchozí model, pokud je nastavenomodel_type: "smart-topology"bezai_model; pro pokračování v používání Meshy T2 nastavteai_model: "meshy-t2". Více obrázků na 3D nepodporujemeshy-t2.5.
Oct 14
model_urlnyní přijímá soubory o velikosti až 400 MB (dříve 100 MB), pokud se jedná o adresu URLhttpnebohttps, u funkcí Retexturování, Remesh, Rigging, Převést, Změnit velikost, UV rozbalení, Vícebarevný tisk, Analyzovat tisknutelnost a Opravit tisknutelnost. Identifikátor URIdata:zůstává na 100 MB. Soubor GLB, glTF, FBX nebo OBJ o velikosti nad 100 MB může mít nejvýše 10 000 000 ploch (8 000 000 pro Vícebarevný tisk), počítáno jako trojúhelníky; soubor s vyšším počtem vrátí400. Nad 100 MB musí být soubor FBX binární FBX verze 7.1 nebo novější a soubor GLB nebo glTF nesmí používat kompresi Draco. Soubor je stažen ještě před vrácením odpovědi na požadavek na vytvoření, takže u velkého souboru počítejte až se 120 sekundami (viz Task Lifecycle). 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, který patří jinému účtu, odpovídá kódem404se stejným tělem odpovědi jako u id, které neexistuje, místo403. Úloha, která patří 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 modely se v AR Quick Look, Reality Composer, Blenderu a dalších prohlížečích USD otevírají ve své skutečné velikosti. Soubor
usdzvmodel_urlsu ú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í deklarujemetersPerUnit = 1. Dosud 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 škálujete faktorem 3,28, abyste to kompenzovali, odstraňte toto škálování u úloh vytvořených od tohoto data. Soubory starších úloh si zachovávají svou aktuální jednotku a soubory USDZ u Riggingu a Animace nejsou dotčeny.
10. října
meshy-5byl 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í400se zprávouai_model meshy-5 has been retired; use meshy-6-lite. Přejděte nameshy-6-lite, který přijímá stejné parametry za stejnou cenu v kreditech. Modely, které jste již vygenerovali pomocímeshy-5, zůstávají dostupné a refine náhledu vytvořeného pomocímeshy-5bez nastaveníai_modelnadále funguje..webpje nyní zdokumentován jako podporovaný vstupní formát obrázku, vedle.jpg,.jpega.png, v 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, tak pro data URI (data:image/webp;base64,...). Stávající integrace nejsou dotčeny a ceny zůstávají nezměněny.- Získat zůstatek nyní vrací také
monthly_credits,permanent_creditsamonthly_resets_at, takže uvidíte, jaká část vašeho zůstatku vyprší při příští obnově.balancesamotné zůstává beze změny.
Oct 6
- Analyzovat tisknutelnost a Opravit tisknutelnost nyní dokážou zkontrolovat tloušťku stěny při velikosti, ve které plánujete tisk. Odešlete
printer_type, velikost tisku, nebo obojí: analýza hlásí tenké stěny vprintability.thin_wallsa oprava je v případě potřeby ztlušťuje a může znovu použít tiskárnu a velikost z úlohy analýzy předané jakoinput_task_id. Integrace, které tato pole nepoužívají, se chovají jako dříve a ceny zůstávají beze změny.
Září 2026
Sep 29
- Zastaralá cesta
/v2/text-to-3d(bez prefixu/openapi) je zastaralé. Prozatím funguje beze změn, 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čkuDeprecationa hlavičkuLinkodkazující 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 opětovným pokusem nebo dotazováním. - Multi-Color Print nyní přijímá nový parametr
printer_brand, který zapíše odpovídající předvolbu slicer do souboru 3MF, takže soubor se 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í). Stránka nyní také dokumentujemax_depth.
18. září
- Přidána hodnota
meshy-7.1proai_modelu Obrázek na 3D, Více obrázků na 3D a Text na 3D: stejné parametry a stejná cena v kreditech jakomeshy-7, vyšší detail geometrie.latestnyní odkazuje nameshy-7.1;meshy-7je zastaralé, ale nadále funguje beze změn. - Do stejných API byl přidán parametr
geometry_resolution(standard/2k/4k), který nahrazuje nyní zastaralý parametrultra_mode(ultra_mode: truestále funguje a odpovídá hodnotě"2k").4kvyžaduje Meshy 7.1 (meshy-7.1nebolatest), není dostupné pro Více obrázků na 3D a stojí stejných 5 kreditů navíc jako2k.
16. září
- Auto Split API nyní přijímá texturovaný
input_task_id. Dříve jej odmítalo s chybou400, což znamenalo, že bylo nutné vygenerovat stejnou síť podruhé s parametremshould_texture: falsejen proto, aby ji bylo možné rozdělit. Všimněte si, co rozdělení vrací: ořízne geometrii a znovu sestaví povrchy každé části, takže textura ze vstupu se nepřenáší a výsledkem je model bez textury s jednou plochou barvou na každou část — to platilo pro každé rozdělení již dříve a nijak se to nemění. meshy-5bude vyřazeno 10. října 2026. Již není dokumentováno jako hodnotaai_modelpro Text na 3D, Obrázek na 3D, Více obrázků na 3D nebo Retexturování, a po 10. říjnu budou požadavky odesílajícíai_model: "meshy-5"vracet chybu.- Sdílený testovací API klíč byl vyřazen; požadavky, které jej stále odesílají, nyní vracejí
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ý spouští 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_modelpro API Text na obrázek a Obrázek na obrázek byly přidánygpt-image-2-5-flareagpt-image-2-5-sunburst. Jedná se o úrovně OpenAI GPT Image 2.5, které mají stejnou cenu jakogpt-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 stran4:3a3:4, kromě1:1,16:9,9:16,3:2a2:3.
Sep 14
- Obrázek na obrázek API nyní přijímá
input_task_id— umožňuje navázat přímo na dokončenou úlohu Text na obrázek nebo Obrázek na obrázek, místo kopírování jejích výstupních URL doreference_image_urls.
Sep 11
- Změna chování:
DELETEúlohy, která je již ve stavuIN_PROGRESS, je nyní odmítnuto s chybou409 Conflicta úloha pokračuje v běhu. Dříve se vracelo200 OK, worker se zastavil a výsledek byl zahozen — přičemž kredity zůstaly odečtené, protože vratné jsou pouze úlohy ve stavuPENDING, takže volání vás stálo jak model, tak 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 již worker začal zpracovávat, nelze zrušit: počkejte na stavSUCCEEDED,FAILEDneboCANCELEDa poté ji smažte. Úlohy ve stavuPENDINGjsou stále mazány a vráceny přesně jako dříve a dokončené (terminální) úlohy jsou stále mazány. Platí pro všechny rodiny úloh pod/openapi. Viz Chyby. - Do dokumentovaných hodnot
ai_modelpro API Text na 3D, Obrázek na 3D, Více obrázků na 3D a Retexturování byl přidánmeshy-6-lite. Jedná se o nástupcemeshy-5: stejné parametry, stejná cena v kreditech (5 za síť, 15 s texturou, 10 za retexturování). meshy-5je 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é požadavky — pokud vaše integrace odesíláai_model: "meshy-5", přejděte nameshy-6-lite.
Sep 9
- Nové Auto Split API: Rozdělte netexturovaný model Meshy 6 nebo Meshy 7 na samostatně tisknutelné díly — automaticky, podle dílů, které pojmenujete (
by_parts), nebo podle barevné oblasti (by_color) — s volitelnými spoji typu pero-drážka a zpevněním tenkých stěn. Exportuje každý díl jako samostatný objekt ve formátuglb,obj,fbx,usdz,blendnebo3mf, buď sestavené, nebo rozložené na tiskové podložce (layout). 10 kreditů za úlohu.
Sep 7
- Do fáze prototypu Creative Lab Keychain API byl přidán parametr
name_text: 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í (build) rytinu automaticky zdědí a objekt úlohy prototypu nyní vracíname_text, abyste si mohli před sestavením ověřit přesný text. Upozorňujeme, ženamezůstává pouze zobrazovaným štítkem úlohy a není vyryto.
5. září
- Přidáno Creative Lab Fidget Pixel API: proměňte fotku na vícebarevnou 3D-tisknutelnou fidget desku v pixel-art stylu ve dvou fázích.
POST /prototype(6 kreditů) zpixeluje fotku do pixel-artového obrázku — zadánímtypejakopersonnebootherzvolíte styl pixelizace — aPOST /build(30 kreditů) ji převzorkuje na mřížku16nebo32a každý pixel promění v do sebe zapadající dílek tvarusquarenebohex, dodaný jako jediný barevně označený soubor 3MF pro tisk s více filamenty. Geometrie dílku je nastavitelná pomocípiece_size_mm,color_countapiece_height_mm.
Sep 4
- Do Knihovny animací byla přidána
GET /openapi/v1/animations/library: umožňuje načíst všechny přednastavené akce, které Animation API akceptuje —action_id, název, kategorii a animovaný GIF náhled — s možností vyhledávání a filtrování podle kategorie, takže si můžete vytvořit vlastní výběr akcí místo procházení referenční tabulky. Zdarma; nespotřebovává žádné kredity. - Přidáno Creative Lab Collapsible Fidget API: proměňte fotografii ve skládací fidget hračku tisknutelnou najednou bez montáže, kde se silueta objektu stane vnořenými soustřednými kruhy, které se dají rozložit naplocho a opět roztáhnout, vytištěné jako jeden celek. Jediný
POSTpožadavek provede obrázek celým procesem až k hotovému modelu — neexistuje zde dvojice fází prototyp/sestavení ani parametry geometrie k ladění. Každá úloha stojí 6 kreditů a vrací jak tisknutelný STL, tak GLB pro náhled.
3. zář
- Creative Lab Lamp API nyní ve fázi prototypu vrací 3D model:
POST /prototypepřevede koncepční obrázek na dutý GLB stínidla lampy a objekt úlohy prototypu nově obsahujemodel_urls.glbathumbnail_urlvedleimage_urls. Fáze build spouští na tomto modelu pouze procesor lampy a nyní vytváří stínidlo s otevřeným spodkem a základní deskou pro světelný zdroj. S touto změnou se mění i ceny: prototyp stojí 30 kreditů a build 6 kreditů (dříve 6 a 30). Parametrtextu prototypu byl odstraněn —image_urlje nyní povinný.
Sep 2
- Animation API nyní přijímá
action_ids— na riggovanou postavu lze v jednom požadavku aplikovat až 10 přednastavených akcí a získat jediný soubor obsahující jednu animační klip pro každou akci, připravený k řízení ze stavového automatu v herním enginu. Klipy si zachovávají pořadí, ve kterém jste je uvedli, a nesou název knihovny animace. Stojí 3 kredity za akci apost_processse vztahuje na sloučený soubor. Dostupná id najdete v Referenci Knihovny animací a ceny v tabulce cen.
Sep 1
- Do Multi-Image to 3D API byl přidán parametr
ultra_mode: umožňuje generování Ultra uai_modelmeshy-7(nebolatest) 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í Image to 3D API, nyní dostupný i se vstupy ve formátu Více pohledů. - Z dokumentovaných hodnot
ai_modelpromodel_typeSmart Topology v rámci Image to 3D API byla odstraněna hodnotameshy-t1. Smart Topology nyní dokumentuje pouzemeshy-t2; nové integrace by měly používat právě ji. U Meshy T1 se plánuje ukončení podpory — pokud vaše integrace aktuálně odesíláai_model: "meshy-t1", přejděte nameshy-t2.
Srpen 2026
Aug 28
- Přidáno Usage API pro Studio a Enterprise týmy: 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— aplikujte pohybový klip vygenerovaný pomocí Text to Motion API na vašeho riggovaného bipedního charakteru, jako alternativu k přednastavenémuaction_id. Stejná cena 3 kredity za úlohu.
Aug 24
- Rozšířena podpora
aspect_ratioprogpt-image-2v API Text na obrázek a Obrázek na obrázek o16:9a9:16.gpt-image-2nyní podporuje1:1,16:9,9:16,3:2a2:3;4:3a3:4zůstávají u tohoto modelu nepodporované.
Aug 21
- Přidáno Text to Motion API: vygenerujte klip pohybu postavy z popisu v přirozeném jazyce, bez nutnosti modelu postavy. Zvolte mode
prime(10 kreditů, výstup ve formátu FBX) pro nejvyšší kvalitu nebo modeswift(3 kredity, výstup ve formátu BVH) pro rychlé a úsporné generování, s délkou klipu 2–10 sekund.
Aug 20
- Do Multi-Color Print API byl přidán parametr
style: zvolterealistic(výchozí) pro barvy odpovídající textuře, nebocartoonpro ploché, jednolité barevné oblasti a menší 3MF. - Do každého koncového bodu prototypu Creative Lab byl přidán parametr
remove_background— Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet a Lamp. Nastavenímremove_background: trueobdržíte obrázek prototypu jako průhledné RGBA PNG s odstraněným pozadím.
Aug 18
- Do Multi-Image to 3D API byl přidán parametr
texture_image_urls: umožňuje zadat 1–4 obrázky stejného objektu pro řízení texturování, místo jednohotexture_image_url. Vyžadujeai_modelmeshy-7nebolatesta je nezávislý naimage_urls— oba seznamy mohou obsahovat různé obrázky i různý počet obrázků.
Aug 17
- Do Text to Image API a Image to Image API byl přidán parametr
remove_background. Nastavenímremove_background: truezískáte vygenerovaný obrázek jako průhledné RGBA PNG s odstraněným pozadím.
Aug 13
- Do Text to 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í parametrultra_modev 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ředejteai_model: "meshy-7"v rámci refine úlohy, nebo parametrai_modelzcela vynechte. - Do Text to 3D API byl přidán
model_typeSmart Topology. Nastavenímmodel_type: "smart-topology"generujete pomocímeshy-t2— čistší topology, přirozeně oddělené části, výstup v trojúhelnících a počet polygonů, 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 funkční.
12. srpna
- Přidán
ai_model: "meshy-7"do Obrázek na 3D API: náš nejnovější model pro generování 3D, s vyšší věrností geometrie než Meshy 6. Zavádí také parametrultra_mode, který umožňuje Ultra generování pro ještě jemnější detaily povrchu. - Přidán
ai_model: "meshy-7"do Více obrázků na 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 na jejich základě řídí texturování. - Přidán
ai_model: "meshy-7"do Retexturování 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é parametrmultiview_image_urls— poskytněte 1–4 seřazené pohledy na stejný objekt pro řízení texturování z více pohledů.
Aug 4
- Rozšířena podpora vstupu
model_urlna.glb,.gltf,.obj,.fbx,.stlpro endpointy Analyzovat tisknutelnost a Opravit tisknutelnost (dříve.glb,.stl,.obj). Oprava vrací opravený asset ve stejném formátu, v jakém byl zadán na vstupu.
Červenec 2026
Jul 27
- Nové Creative Lab — Brick Figure API: promění fotografii ve sběratelskou 3D minifigurku ve stylu stavebnice. Stejný dvoufázový postup jako u Figure API —
prototype(6 kreditů) vygeneruje stylizovaný koncepční obrázek,build(30 kreditů) jej promění v texturovaný 3D model s výstupy GLB a OBJ + MTL. Úplný přehled najdete v sekci Ceny.
22. července
- Nové Creative Lab — Keycap API: promění fotografii v plnobarevnou vlastní klávesu mechanické klávesnice. Dvoufázový pracovní postup —
prototype(12 kreditů) vygeneruje render hotového návrhu klávesy, potébuild(50 kreditů) převede vybraný návrh (pomocícandidate_id) na texturovaný 3D model klávesy s výstupy ve formátu GLB a OBJ v jednom balíčku, exportovaný ve skutečné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 hodnotě8kjsou PBR mapy generovány ve 4K a není vytvořena žádná emisní mapa. Generování 8K textury stojí 15 kreditů (2k/4kzůstávají na 10). Viz Ceny. - Booleovský parametr
hd_textureje zastaralé ve prospěchtexture_resolution— stále je však respektován a pro zpětnou kompatibilitu odpovídá hodnotětexture_resolution: "4k".
20. července
- Nová Creative Lab — Vinyl Figure API: proměňte fotografii ve sběratelskou 3D figurku s velkou hlavou ve stylu vinylového panáčka. Stejný dvoufázový postup jako u Figure API —
prototype(6 kreditů) vygeneruje stylizovaný koncepční obrázek,build(30 kreditů) jej přemění na texturovaný 3D model s výstupy GLB a OBJ + MTL. Úplný přehled najdete v sekci Ceny.
13. července
- Do API Obrázek na 3D byl přidán nový
model_typeSmart Topology, který nabízí dva modely prostřednictvímai_model:meshy-t1— stávající low-poly model — ameshy-t2— nový model s čistší topology, nativně oddělenými částmi, trojúhelníkovým výstupem a počtem ploch, který lze nastavit pomocítarget_polycount.meshy-t2je výchozí volbou podsmart-topology. Stávajícímodel_type: lowpolyje nyní zastaralé, ale kvůli zpětné kompatibilitě je nadále v provozu.
7. července
- Přidán parametr
aspect_ratiodo API Obrázek na obrázek, díky kterému můžete při úpravách ovládat poměr stran výstupního obrázku. Povolené hodnoty jsou1:1,16:9,9:16,4:3,3:4pro modely nano-banana a1:1,3:2,2:3progpt-image-2. Volitelný; výchozí hodnota je1:1a nelze jej kombinovat sgenerate_multi_view.
Červen 2026
17. června
- 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. červen
- Nové UV Unwrap API: vygeneruje vysoce kvalitní UV rozvržení pro existující 3D model — nezbytný krok před texturováním, nebo kdykoli 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), nebomodel_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ší, spusťte nejprve Remesh); sítě se čtyřúhelníky a n-úhelníky jsou během generování UV triangulovány.
Jun 12
- Aktualizovány ceny Creative Lab API Build na 30 kreditů za volání pro Keychain, Fridge Magnet a Figure (dříve 20). Lamp 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 Pricing.
Jun 5
- Přidán volitelný parametr
alpha_thumbnaildo API Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh a Repair Printability. Při nastavení natrueúloha navíc vykreslí verzi náhledu s průhledným pozadím (RGBA) a vrátí ji v novém poli odpovědialpha_thumbnail_url. Stávajícíthumbnail_urlzůstává beze změny. Výchozí hodnota jefalse.
Jun 1
- Nové Creative Lab API: skupina endpointů zaměřených na konkrétní produkty, které promění zdrojovou fotografii (nebo textový prompt) ve 3D tisknutelný spotřebitelský produkt. Při spuštění jsou k dispozici čtyři produkty — klíčenka, magnet na lednici, figurka a lampa. Každý z nich prochází dvoufázovým postupem
prototype→build, propojeným pomocíinput_task_id, a je dostupný pod URL adresami vázanými na konkrétní produkt (/openapi/creative-lab/<product>/v1/...) s verzováním pro každý produkt zvlášť, takže se jednotlivé 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. Je-li nastaven natrue, úloha navíc vykreslí čtyři pohledy ze základních světových stran (zepředu, zprava, zezadu, zleva) a vrátí je v novém poli odpovědithumbnail_urls. Stávající polethumbnail_urlzů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 natrue, úloha navíc vykreslí čtyři náhledy ze základních světových stran (přední, pravý, zadní, levý) a vrátí je v novém poli odpovědithumbnail_urls. Stávající polethumbnail_urlzůstává beze změny. Zpracování úlohy se tím prodlouží přibližně o 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 rámce odpovídal zadané hodnotě v metrech. Je vzájemně neslučitelný sresize_heightaauto_size.
11. května
- Zastaralý parametr
symmetry_modena endpointech Text na 3D, Obrázek na 3D a Více obrázků na 3D. Tento parametr již neovlivňuje výstup.
7. května
- Nové Analyze Printability API: Analyzuje úspěšný úkol Meshy — nebo jakoukoli URL adresu 3D modelu — z hlediska připravenosti na 3D tisk metodou FDM. Vzor asynchronního vytvoření + streamování: POST vrátí task_id, poté GET / SSE stream vrátí po stavu SUCCEEDED metriky vodotěsnosti, objemu, otvorů a non-manifold hran. Zdarma, bez spotřeby kreditů.
- Nové Repair Printability API: Opraví 3D model z hlediska tisknutelnosti metodou FDM — opraví non-manifold hrany, degenerované plochy, otvory a další problémy s topology. Přijímá existující
input_task_idz Meshy nebomodel_url(.glb,.stl,.obj). Výstupní formát odpovídá vstupnímu. 10 kreditů za úkol.
Duben 2026
Apr 27
- Do všech odpovědí úloh napříč všemi koncovými body API bylo přidáno pole
consumed_credits. Zobrazuje počet kreditů spotřebovaných danou úlohou. Pole je přítomno u úloh ve stavechPENDING,IN_PROGRESSaSUCCEEDED. U úloh se stavemFAILEDvrací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 Vícebarevný tisk byl přidán parametr
model_url. Umožňuje odeslat texturovaný 3D model přímo (prostřednictvím URL nebo Data URI) namístoinput_task_idz předchozí úlohy Meshy. Podporované formáty:.glb,.fbx. Pokud jsou zadány oba parametry,model_urliinput_task_id, má přednostinput_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áinput_task_idpřednost.
20. dubna
- Do endpointů Obrázek na 3D, Více obrázků na 3D, Text na 3D Refine a Retexturování byl přidán parametr
hd_texture. Je-li povolen, textura základní barvy se vygeneruje v rozlišení 4K (4096×4096) pro vyšší detail. Podporováno pouze promeshy-6alatest. Výchozí hodnota jefalse. - PBR balíček vracený, když je
enable_pbrnastaveno natrue, nyní obsahuje mapuemissionv rámcitexture_urlsu úlohmeshy-6alatestnapříč endpointy Obrázek na 3D, Více obrázků na 3D, Text na 3D Refine a Retexturování. Žádná změna požadavku není nutná.
Apr 14
- Přidán parametr
decimation_modedo endpointů Obrázek na 3D, Více obrázků na 3D, Text na 3D Preview a Remesh. Nastavuje úroveň adaptivního počtu polygonů při decimaci:1(ultra),2(vysoká),3(střední) nebo4(nízká).
Apr 12
- Restrukturalizována API dokumentace: přidáno seskupování parametrů se závislými poli, vložené výchozí hodnoty, odznaky pro povinné/zastaralé parametry, rozbalitelná podnavigace a rozdělení Více obrázků, Riggingu a Animace do samostatných stránek.
Březen 2026
Apr 2
- Přidána podpora formátu
3mfdo parametrutarget_formatsnapříč všemi endpointy (Obrázek na 3D, Text na 3D, Remesh, Retexturování). Poznámka: 3MF je volitelná funkce a musí být explicitně vyžádána. - Nové Multi-Color Print API: Převod 3D modelů do vícebarevného formátu 3MF pro 3D tisk. Podporuje palety 1-16 barev s nastavitelnou přesností. 10 kreditů za úlohu.
Mar 20
- Byl ukončen provoz AI modelu Meshy-4. Všechny API požadavky používající
meshy-4již nejsou podporovány. Přejděte prosím nameshy-6nebolatest. - Do endpointů Obrázek na 3D, Více obrázků na 3D, Text na 3D a Remesh byly přidány parametry
auto_sizeaorigin_at. Je-liauto_sizepovoleno, služba pomocí AI vidění odhadne skutečnou výšku a model automaticky upraví velikost.origin_atnastavuje pozici počátku (bottomnebocenter). V API pro Remesh seauto_sizevzájemně vylučuje sresize_height.
Mar 17
- Do endpointů Obrázek na 3D, Více obrázků na 3D, Text na 3D a Retexturování byl přidán volitelný parametr
target_formats. Určete, které 3D formáty se mají vygenerovat (např.["glb", "fbx"]), abyste zkrátili dobu dokončení úlohy.
Únor 2026
Feb 28
- Do API Obrázek na 3D, Více obrázků na 3D, Text na 3D Refine a Retexturování byl přidán parametr
remove_lighting. Odstraní odlesky a stíny ze základní barevné textury pro čistší výsledky při vlastním osvětlení. Podporováno pouze promeshy-6alatest. Výchozí hodnota jetrue. - API Retexturování a Text na 3D Refine nyní podporují hodnotu
meshy-6pro parametrai_modelpro plné texturování Meshy 6.
Feb 25
- Do Image to 3D a Více obrázků na 3D API byl přidán parametr
image_enhancementpro uživatele, kteří chtějí vypnout optimalizaci vstupního obrázku a zachovat přesný vzhled svého vstupu. Podporováno pouze promeshy-6alatest. Výchozí hodnota jetrue.
Feb 20
- Do Text na 3D Preview API byl přidán parametr
model_typepro generování low-poly sítí optimalizovaných pro čistší polygony.
Leden 2026
Jan 27
- Pro všechny API endpointy byla přidána podrobná dokumentace Chybových stavů, včetně běžných kódů chyb HTTP (400, 401, 402, 404, 422, 429) a důvodů selhání úloh. Toto vývojářům pomáhá lépe porozumět chybám API a lépe s nimi pracovat.
Jan 26
- API Více obrázků na 3D nyní podporuje Meshy-6 pro úplné generování sítě. Parametr
ai_modelnyní přijímá hodnotumeshy-6a hodnotalatestse přeloží na Meshy 6.
Jan 22
- Zastaralý parametr
art_stylepro API Text na 3D Preview (Meshy-6). Tento parametr byl navržen pro zastaralé modely (Meshy-4 / Meshy-5) a v budoucí verzi bude odstraněn. - Zastaralý parametr
enable_pbrpro API Text na 3D a Obrázek na 3D, pokud jeai_modelnastaveno nameshy-4. Tento parametr bude v budoucí verzi odstraněn. - Aktualizována výchozí hodnota parametru
should_remeshpro Meshy-6 v API Text na 3D a Obrázek na 3D. Parametr má nyní výchozí hodnotufalsepromeshy-6atruepro ostatní modely, pokud není zadáno jinak.
Jan 19
- Volba
latestproai_modelv API Text na 3D (Preview) a Obrázek na 3D nyní odkazuje na Meshy 6.
Jan 12
- Do API Obrázek na 3D byl přidán nový parametr
model_typepro generování low-poly sítí optimalizovaných pro čistší polygony.
Prosinec 2025
Dec 31
- Spuštěn API Playground, vyhrazený prostor pro vývojáře, kde mohou prozkoumávat parametry API a testovat požadavky 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-bananaanano-banana-pro, s volitelným generováním více pohledů.
Dec 22
- Pole
video_urlv odpovědi API Text na 3D je nyní zastaralé a bude v budoucí verzi odstraněno.
Dec 04
- Do API Text na 3D Preview, Obrázek na 3D a Více obrázků na 3D byl přidán nový parametr
pose_mode. Tento parametr přijímá hodnotya-pose,t-posenebo prázdný řetězec (výchozí). Parametris_a_t_poseje nyní zastaralé ve prospěchpose_mode.
Listopad 2025
Nov 24
- API Obrázek na 3D a Více obrázků na 3D přidávají volitelný parametr
save_pre_remeshed_modela 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 = latestashould_texture = true. - API Více obrázků na 3D nyní podporuje
ai_model = latest, přičemž pro texturování standardně běží Meshy-6-preview, zatímco generování sítě zůstává na Meshy-5. - API Retexturování přidává možnost
latestproai_model(Meshy-6-preview) a nyní ji při vynechání parametru 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-versionindikující aktuální verzi API serveru.
Oct 20
- Přidán volitelný booleovský parametr
convert_format_onlydo Remesh API pro podporu převodu formátu vstupního souboru modelu bez dalších úprav. - Přidáno
rigged_character_glb_urldo odpovědi objektu úkolu riggingu.
Oct 01
- Odstranění API pro
text-to-voxel
Září 2025
Sep 23
- Přidána možnost
latestproai_modelv API Text na 3D pro použití Meshy 6 Preview. - Dočasná 50% sleva na úlohy generování Meshy-6-preview, která snižuje cenu na 10 kreditů a bude platit do 30. září 2025. Po skončení období slevy se cena úloh Meshy-6-preview vrátí na běžných 20 kreditů.
Sep 18
- Aktualizovány ceny API pro Text na 3D a Obrázek na 3D, aby odrážely rozdílné náklady pro Meshy 6 a ostatní modely.
Sep 16
- Přidána možnost
latestproai_modelv API Obrázek na 3D pro použití Meshy 6 Preview.
Sep 4
- Rozšířena podpora vstupu
model_urlo formáty.glb,.gltf,.obj,.fbx,.stlpro Remesh a Retexturování.
Srpen 2025
Aug 18
- Přidán volitelný parametr
is_a_t_posedo API Text na 3D Preview, Obrázek na 3D a Více obrázků na 3D pro generování modelů v pozici A/T.
Aug 13
- Meshy 5 je nyní stabilní pro Text na 3D a Obrázek na 3D (
ai_model:meshy-5), což přináší vylepšenou kvalitu a konzistenci.
Červenec 2025
Jul 31
- Podpora PBR textur v API prostřednictvím parametru
enable_pbrpro nejnovější modelmeshy-5pro endpointy Text na 3D, Obrázek na 3D, Více obrázků na 3D a Retexturování.
Č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
- Přidána API pro mazání u Text na 3D, Obrázek na 3D, Remesh, Rigging a Animace.
- Přidán parametr
ai_modeldo Text to 3D Refine API.
Jun 17
- Přidána dokumentace pro Webhooks.
Jun 10
- Remesh API nyní podporuje modely GLB kódované v base64 v parametru
model_urlprostřednictvím Data URI.
Květen 2025
May 20
- Do API Text to 3D Preview, Text to 3D Refine, Obrázek na 3D a Více obrázků na 3D byl přidán volitelný parametr
moderation. Pokud je povolen, je vstupní obsah před generováním automaticky kontrolován na potenciálně škodlivý obsah.
May 15
- Zavedeno automatické rigování a Animace API, které uživatelům umožňuje automaticky rigovat a animovat 3D modely. Zjistěte více o rigování a Animaci.
Duben 2025
Apr 29
- Zavedeno Více obrázků na 3D API, které umožňuje generování 3D modelů z 1 až 4 vstupních obrázků pomocí AI modelu
meshy-5. - Přidána možnost AI modelu
meshy-5do API Text na 3D a Obrázek na 3D. Značkalatestnyní také odkazuje nameshy-5.
17. dubna
- Do API Obrázek na 3D a Text na 3D Refine byl přidán parametr
texture_image_url, který umožňuje uživatelům ří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 vyšší kvalitu generování.
Mar 14
- Text to Texture API nyní podporuje modely zakódované v base64 v parametru
model_urlprostřednictvím Data URI, podobně jakoimage_urlv API Obrázek na 3D.
Mar 06
- Aktualizovány ceny pro úlohy generování přes API:
- 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 na 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 otestovat integraci API bez spotřeby kreditů. Všechny platné požadavky s tímto klíčem vrátí stejné ukázkové výsledky úloh.
Feb 13
-
Zásadní změny:
- Vytváření úloh na bezplatné úrovni skončí
20. března 2025. Poté budou všechny požadavky na API úlohy vyžadovat placené předplatné. Abyste si zajistili plynulý přístup, doporučujeme upgradovat před tímto termínem. - Použijte kód kupónu
APIACCESSa získejte slevu40 %. Děkujeme, že jste s námi!
- Vytváření úloh na bezplatné úrovni skončí
-
Přidány streamovací endpointy Server-Sent Events (SSE) pro aktualizace úloh v reálném čase:
6. únor
- Do API Obrázek na 3D a Text na 3D Refine byl přidán parametr
texture_prompt, který umožňuje uživatelům řídit proces generování textury pomocí textového promptu.
Leden 2025
23. leden
- Do API Text na 3D, Obrázek na 3D, Remesh a Text na texturu byly přidány endpointy pro výpis úloh.
Jan 14
- Zastaralé (deprecated) staré API pro Text na 3D a Obrázek na 3D poháněné AI modely Meshy-3.
Jan 07
- Přidán parametr
symmetry_modedo API Text to 3D Preview a Image to 3D, který umožňuje konfigurovatelná nastavení symetrie.
December 2024
Dec 19
- Přidáno Remesh API, které umožňuje uživatelům provádět remesh a exportovat existující 3D modely vytvořené pomocí jiných API Meshy do различных formátů.
- Aktualizovány limity počtu polygonů pro naše API na rozsah 100–300 000 pro Premium uživatele.
Dec 12
- Zastaralý parametr
model_urlve všech odpovědích API. - Oddělili jsme zastaralé API Meshy-3 od nejnovějšího API Meshy-4.
Dec 10
- Přidán parametr
enable_pbrdo API Obrázek na 3D a Text na 3D Refine. - Přidán parametr
should_texturedo API Obrázek na 3D. - Zastaralá volba
pbrv parametruart_stylepro API Text na 3D Preview při použití AI modelumeshy-4. - Zastaralá volba
low-polyv parametruart_stylepro API Text na 3D Preview.
Dec 5
- Přidáno Get Balance API, které uživatelům umožňuje zjistit zůstatek creditů.
- Přidán parametr
should_remeshdo API Obrázek na 3D a Text na 3D Preview.
Dec 3
- Externí API nyní používají prefix
/openapi. Zastaralé (Legacy) cesty zůstávají podporovány, doporučujeme však přejít na nové cesty.
Listopad 2024
Nov 14
- API Obrázek na 3D nyní podporuje obrázky kódované v base64.