Changelog

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

Září 2026

Sep 3

  • Fáze prototypu v Creative Lab Lamp API nyní vrací 3D model: POST /prototype přemění koncepční obrázek na dutý stínítko lampy ve formátu GLB 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 lampy a nyní vytváří stínítko s otevřeným dnem a základovou deskou pro světelný zdroj. Ceny se mění společně s náročností práce: prototyp stojí 30 kreditů a sestavení 6 kreditů (dříve 6 a 30). Parametr text u prototypu byl odstraněn — nyní je vyžadován image_url.

Sep 1

  • Do Multi-Image to 3D API byl přidán parametr ultra_mode: umožňuje generování Ultra 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í Image to 3D API, nyní dostupný i se vstupy s více pohledy.
  • Z dokumentovaných hodnot ai_model pro model_type Smart Topology v Image to 3D API byl odstraněn meshy-t1. Smart Topology nyní dokumentuje pouze meshy-t2; nové integrace by měly používat právě ji. 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é využití API úloh — koncový bod, stav, časová razítka, API klíč, který každou ú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 svou riggovanou bipední postavu, jako alternativu k předdefinované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 o hodnoty 16:9 a 9:16. Model gpt-image-2 nyní podporuje 1:1, 16:9, 9:16, 3:2 a 2:3; 4:3 a 3:4 u tohoto modelu zůstávají nepodporované.

Aug 21

  • Přidáno Text to Motion API: vygenerujte klip s pohybem 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 mode swift (3 kredity, výstup ve formátu BVH) pro rychlé a úsporné generování, s délkou klipu 2–10 sekund.

Aug 20

  • Přidán parametr style do Multi-Color Print API: vyberte realistic (výchozí) pro barvy věrné textuře, nebo cartoon pro ploché, jednotné barevné oblasti a menší soubor 3MF.
  • Přidán parametr remove_background do každého koncového bodu prototypů Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet a Lamp. Nastavením remove_background: true získáte obrázek prototypu jako transparentní 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 poskytnout 1–4 obrázky téhož objektu pro řízení texturování místo jediného 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 i odlišný počet obrázků.

Aug 17

  • Do Text to Image API a Image to Image API byl přidán parametr remove_background. Nastavením remove_background: true obdrží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 věrnější geometrií než Meshy 6. Zároveň zavádí parametr ultra_mode v úloze preview, 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 úloze refine, nebo parametr ai_model zcela vynechte.
  • Do Text to 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). Preview ve 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

  • Do API Obrázek na 3D byl přidán ai_model: "meshy-7": 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.
  • Do API Více obrázků na 3D byl přidán ai_model: "meshy-7": model Meshy pro generování z více pohledů, který zohledňuje všechny vaše vstupní pohledy společně a na jejich základě řídí texturování.
  • Do API Retexturování byl přidán ai_model: "meshy-7": 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–4 seřazené pohledy stejného objektu pro řízení texturování z více pohledů.

Aug 4

  • Rozšířena podpora vstupu model_url na formáty .glb, .gltf, .obj, .fbx, .stl pro endpointy Analyzovat tisknutelnost a Opravit tisknutelnost (dříve pouze .glb, .stl, .obj). Oprava vrací opravený asset ve vstupním formátu.

Červenec 2026

Jul 27

  • Nové Creative Lab — Brick Figure API: proměňte 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 naleznete na stránce Ceny.

Jul 22

  • Nové Creative Lab — Keycap API: proměňte fotografii ve full-color 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řemění vybraný návrh (pomocí candidate_id) na texturovaný 3D model klávesy s výstupy ve formátu GLB a OBJ, exportovaný ve skutečném měřítku v milimetrech. V současnosti podporuje standardní základnu Cherry MX 1u (cherry-mx-1x1-r1); do budoucna jsou plánovány další standardní velikosti. Ú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 emisní mapa se nevytváří. Generování 8K textury stojí 15 kreditů (2k/4k zůstává na 10). Viz Ceny.
  • Boolean hd_texture je zastaralé ve prospěch texture_resolution — z důvodu zpětné kompatibility je stále respektováno a odpovídá hodnotě texture_resolution: "4k".

20. července

  • Nové Creative Lab — Vinyl Figure API: promění fotku na velkohlavou vinylovou sběratelskou 3D figurku. 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.

13. července

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

Jul 7

  • Přidán parametr aspect_ratio do API Obrázek na obrázek, takže 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ý; 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 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), nebo model_url (pouze .glb) a vrací „UV bílý model“ se zcela novými UV souřadnicemi. 5 kreditů za volání. Podporuje sítě s až 40 000 plochami (pokud je jich více, nejprve spusťte Remesh); čtyřúhelníkové a n-úhelníkové sítě jsou během generování UV triangulovány.

12. června

  • 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. Kompletní přehled najdete v Ceny.

5. června

Jun 1

  • Nové Creative Lab API: rodina endpointů zaměřených na konkrétní produkty, které promění zdrojovou fotografii (nebo textový prompt) na spotřební produkt vhodný k 3D tisku. 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 pracovním postupem prototype → build, propojeným pomocí input_task_id, a je poskytován pod URL adresami vázanými na konkrétní produkt (/openapi/creative-lab/<product>/v1/...) s vlastním verzováním pro každý produkt, aby se produkty mohly vyvíjet na nezávislých verzní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 náhledy ze čtyř základních pohledů (přední, pravý, zadní, levý) 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á přibližně 3 sekundy k latenci úlohy.

May 22

  • Funkce převodu a změny velikosti z Remesh API je 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 vygeneruje č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ědi thumbnail_urls. Stávající pole thumbnail_url zůstává beze změny. Přidává přibližně 3 sekundy k latenci úlohy.

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ámečku 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: Analyzuje úspěšně dokončenou úlohu Meshy — nebo jakoukoli URL adresu 3D modelu — z hlediska připravenosti na 3D tisk technologií FDM. Vzor asynchronního vytvoření + streamování: POST vrátí task_id, poté GET / SSE stream vrátí po dosažení stavu SUCCEEDED metriky vodotěsnosti, objemu, děr a non-manifold hran. Zdarma, nespotřebovává žádné kredity.
  • Nové Repair Printability API: Opraví 3D model z hlediska tisknutelnosti pro FDM tisk — opraví non-manifold hrany, degenerované plochy, díry a další problémy 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

  • Do všech odpovědí úloh napříč všemi API koncovými body bylo přidáno pole consumed_credits. Zobrazuje počet kreditů spotřebovaných danou úlohou. Toto pole je přítomné u úloh ve stavu PENDING, IN_PROGRESS a SUCCEEDED. U úloh se stavem FAILED vrací 0 (kredity jsou při 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 (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.

Apr 21

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

Apr 20

14. dubna

12. dubna

  • Restrukturalizována dokumentace API: přidáno seskupování parametrů se závislými poli, vloženými výchozími hodnotami, štítky pro povinné/zastaralé parametry, rozbalitelná dílčí navigace a rozdělení Multi-Image, Rigging a Animation 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 pouze volitelné a musí být výslovně vyžádáno.
  • Nové Multi-Color Print API: Převeďte 3D modely 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

  • Ukončena podpora AI modelu Meshy-4. Všechny API požadavky používající meshy-4 již nejsou podporovány. Přejděte prosím na meshy-6 nebo latest.
  • Přidány parametry auto_size a origin_at do endpointů Obrázek na 3D, Více obrázků na 3D, Text na 3D a Remesh. Když je povoleno auto_size, služba použije AI vidění k odhadu skutečné výšky a automaticky změní velikost modelu. origin_at nastavuje polohu 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í zrušit 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

Jan 27

  • Byla přidána podrobná dokumentace Failure Modes pro všechny API endpointy, včetně běžných kódů chyb HTTP (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 zvládat je.

Jan 26

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

Jan 22

  • Zastaralý parametr art_style pro API Obrázek 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_pbr pro API Text na 3D a Obrázek na 3D, pokud je ai_model roven 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. Parametr má nyní výchozí hodnotu false pro meshy-6 a true pro ostatní modely, pokud není zadán.

Jan 19

Jan 12

  • 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

Dec 31

  • Byl spuštěn API Playground, specializovaný prostor pro vývojáře k prozkoumávání parametrů API a testování požadavků přímo na webu Meshy.
  • Byly představeny Text to Image API a Image to Image API, umožňující generování obrázků pomocí AI z textových zadání 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ů.

Dec 22

  • Pole video_url v odpovědi API Text na 3D je nyní zastaralé a v budoucí verzi bude 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á hodnoty a-pose, t-pose nebo prázdný řetězec (výchozí). Parametr is_a_t_pose je nyní zastaralý ve prospěch parametru pose_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_model a zpřístupňují model_urls.pre_remeshed_glb, pokud je vyžádána záloha modelu před remeshem.

Nov 06

  • API Text na 3D Refine nyní podporuje ai_model = latest, což odpovídá Meshy 6 Preview.
  • API Obrázek na 3D nyní ve výchozím nastavení 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 ve výchozím nastavení používá Meshy-6-preview, zatímco generování sítě zůstává na Meshy-5.
  • API Retexturování přidává pro parametr ai_model možnost latest (Meshy-6-preview) a nyní ji používá jako výchozí, pokud není zadána.

04. listopadu

  • 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

28. října

  • Přidána response header x-api-version, která udává aktuální verzi API serveru.

20. října

  • Přidán volitelný booleovský parametr convert_format_only do Remesh API, který umožňuje 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 platí pro generovací úlohy Meshy-6-preview, které nyní stojí 10 kreditů, a to až do 30. září 2025. Po skončení slevového období se cena úloh Meshy-6-preview vrátí na standardních 20 kreditů.

Sep 18

Sep 16

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

Sep 4

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

Srpen 2025

Aug 18

Aug 13

  • Meshy 5 je nyní stabilní pro Text na 3D a Obrázek na 3D (ai_model: meshy-5), což přináší vyšší kvalitu a konzistenci.

Č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

Jun 10

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

May 2025

May 20

15. května

Duben 2025

29. dubna

  • Zavedeno API pro Více obrázků na 3D, umožňující 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 výběru AI modelu meshy-5. Značka latest nyní také odkazuje na meshy-5.

Apr 17

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

Březen 2025

Mar 28

  • Přidán parametr latest do API Text na 3D a Obrázek na 3D, umožňující přístup k našim připravovaným pokročilým AI modelům pro vyšší kvalitu generování.

Mar 14

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á 5 kreditů za volání

Únor 2025

Feb 18

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

Feb 13

  • Zásadní změny:

    • Vytváření úloh v bezplatné úrovni skončí 20. března 2025. Poté budou všechny požadavky na úlohy API vyžadovat placené předplatné. Aby byl váš přístup bez přerušení, 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í Server-Sent Events (SSE) pro aktualizace úloh v reálném čase:

6. února

  • 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. ledna

Jan 14

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

Jan 07

Prosinec 2024

Dec 19

  • Přidána Remesh API, která uživatelům umožňují provést 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–300 000 pro uživatele s předplatným Premium.

Dec 12

  • Zastaralý parametr model_url ve všech odpovědích API.
  • Oddělené starší API Meshy-3 od nejnovějšího API Meshy-4.

Dec 10

Dec 5

Dec 3

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

November 2024

Nov 14