changelog
Scopri tutte le ultime funzionalità e gli aggiornamenti di Meshy API e dei plugin.
Preferisci un feed in tempo reale? Le ultime novità compaiono anche nella pagina panoramica della Developer Platform.
Ottobre 2026
Oct 30
- Meshy T1 (
model_type: "lowpoly"eai_model: "meshy-t1") è stato ritirato da Testo in 3D e Immagine in 3D, emodel_type: "smart-topology"conai_model: "meshy-t2.5"lo sostituisce. - L'API di Auto Split ha un nuovo parametro opzionale,
keep_texture. Conkeep_texture: true, ogni parte di un modello texturizzato mantiene la texture, e il task restituisce le mappe di texture intexture_urls, oltre a un filemtlinsieme a un OBJ. Senza di esso, una suddivisione funziona come prima. Una suddivisione che mantiene la texture richiede circa il doppio del tempo e costa comunque 10 crediti.input_task_idaccetta anche i task refine di Testo in 3D e Retexture.
Oct 26
- Nuova pagina Deprecations: il ciclo di vita di ogni modello di generazione 3D (attivo, legacy, deprecato o ritirato) con la relativa data di ritiro e il sostituto consigliato, la cronologia di ogni deprecazione dell'API e i parametri deprecati ancora in servizio. Il banner di ritiro nelle pagine dell'API ora rimanda a questa pagina.
Oct 23
- Deprecato
texture_image_urlsu Rigging. Meshy utilizza le texture incorporate nel filemodel_url, oppure le texture del task di input, quindi omettilo quando il modello possiede già le proprie texture. Se lo invii, l'immagine diventa l'unica texture del modello riggato e il modello perde le sue mappe PBR.
Oct 21
- Aggiunta l'header
X-Meshy-Metadataper i team Studio ed Enterprise a ogni endpoint che crea un task, ad eccezione degli endpoint di Creative Lab. Contrassegna un task con le tue coppie chiave-valore personalizzate, comeuser=alex@example.com,team=fab, e leggile successivamente nel campometadatadei record Usage. Consulta Metadata.
Oct 19
export_resolutionora accetta valori fino a512, ridotti rispetto ai precedenti2048, nei task di build di Keychain e Fridge Magnet.512è la risoluzione della mappa di profondità da cui viene costruita la geometria, quindi ogni valore superiore inseriva vertici aggiuntivi tra campioni già esistenti, generando un file più grande che descrive la stessa superficie.512è anche il valore predefinito, quindi chi non ha mai impostatoexport_resolutionnon è interessato dalla modifica. Un valore superiore a512ora restituisce400al momento della creazione invece di essere accettato.2048in particolare superava sempre il limite di tempo del generatore e falliva dopo che il task era già iniziato. Se avevi impostatoexport_resolutionsopra512, rimuovi il parametro oppure impostalo a512.
Oct 15
- Aggiunto
ai_model: "meshy-t2.5"alle API Immagine in 3D e Testo in 3D: il modello Smart Topology più recente, con dettagli più nitidi per gli asset di gioco. Utilizzalo conmodel_type: "smart-topology"; l'output è composto solo da triangoli etarget_polycountaccetta valori da 100 a 30.000 (predefinito 15.000). I prezzi sono gli stessi dimeshy-t2; consulta Prezzi. Ora è il modello predefinito quandomodel_type: "smart-topology"viene impostato senzaai_model; impostaai_model: "meshy-t2"per continuare a usare Meshy T2. Multi-immagine in 3D non supportameshy-t2.5.
Oct 14
model_urlora accetta file fino a 400 MB, rispetto ai precedenti 100 MB, quando si tratta di un URLhttpohttps, su Retexture, Remesh, Rigging, Converti, Ridimensiona, Unwrap UV, Multi-Color Print, Analizza stampabilità e Ripara stampabilità. Un URIdata:resta limitato a 100 MB. Un file GLB, glTF, FBX o OBJ oltre i 100 MB può avere al massimo 10.000.000 di facce (8.000.000 per Multi-Color Print), contate come triangoli; un file con un numero superiore restituisce400. Oltre i 100 MB, un file FBX deve essere in formato binario FBX 7.1 o successivo, e un file GLB o glTF non deve utilizzare la compressione Draco. Il file viene scaricato prima che la richiesta di creazione restituisca una risposta, quindi prevedi fino a 120 secondi per un file di grandi dimensioni (vedi Task Lifecycle). I file di 100 MB o meno si comportano come prima, e i prezzi restano invariati.- Analizza stampabilità ora risponde a un
input_task_idappartenente a un altro account con404e lo stesso corpo di un id inesistente, invece che con403. Un task tuo, o di un collega nello spazio di lavoro a cui appartieni, funziona come prima.
Oct 12
- I file USDZ ora utilizzano i metri, quindi i modelli si aprono alla loro dimensione reale in AR Quick Look, Reality Composer, Blender e altri visualizzatori USD. Il file
usdzinmodel_urlsdei task di Testo in 3D, Immagine in 3D, Multi-immagine in 3D, Retexture, Remesh, Converti, Ridimensiona e Auto Split ora dichiarametersPerUnit = 1. Fino ad ora dichiarava i piedi (metersPerUnit = 0.3048) mentre le sue coordinate erano in metri, quindi il modello veniva mostrato al 30,48% della sua dimensione. Se scali i file USDZ di 3,28 per compensare, rimuovi questo ridimensionamento per i task creati a partire da questa data in poi. I file dei task precedenti mantengono la loro unità attuale, e i file USDZ di Rigging e Animazione non sono interessati.
Oct 10
meshy-5è stato ritirato. Le richieste che invianoai_model: "meshy-5"a Testo in 3D, Immagine in 3D, Multi-immagine in 3D o Retexture ora restituiscono400con il messaggioai_model meshy-5 has been retired; use meshy-6-lite. Passa ameshy-6-lite, che accetta gli stessi parametri allo stesso costo in crediti. I modelli già generati conmeshy-5restano disponibili, e il refine di un'anteprimameshy-5senza impostareai_modelcontinua a funzionare..webpè ora documentato come formato di input immagine supportato, insieme a.jpg,.jpege.png, su Immagine in 3D, Multi-immagine in 3D, Immagine in immagine, Retexture (image_style_url) e Testo in 3D Refine (texture_image_url). Funziona sia per URL pubblici che per data URI (data:image/webp;base64,...). Le integrazioni esistenti non sono interessate e i prezzi restano invariati.- Get Balance ora restituisce anche
monthly_credits,permanent_creditsemonthly_resets_at, in modo da poter vedere quanta parte del tuo saldo scade al prossimo rinnovo.balancestesso resta invariato.
6 ott
- Analizza stampabilità e Ripara stampabilità possono ora verificare lo spessore parete nelle dimensioni in cui si intende stampare. Invia
printer_type, una dimensione di stampa, o entrambi. L'analisi segnala le pareti sottili inprintability.thin_walls, e la riparazione le ispessisce quando necessario, potendo riutilizzare la stampante e la dimensione di un'attività di analisi passata comeinput_task_id. Le integrazioni che non utilizzano questi campi si comportano come prima, e i prezzi restano invariati.
Settembre 2026
Sep 29
- Il percorso legacy
/v2/text-to-3d(senza il prefisso/openapi) è deprecato. Continua a funzionare senza modifiche per ora, ma verrà rimosso in una futura versione. Passa a/openapi/v2/text-to-3d, che accetta la stessa richiesta e restituisce la stessa risposta. Le risposte sul percorso legacy ora includono un headerDeprecatione un headerLinkche punta al nuovo percorso.
Sep 28
- Le risposte delle API ora includono gli header del limite di frequenza, incluso
Retry-Afterper indicare quanto tempo attendere prima di riprovare o effettuare un nuovo polling. - Multi-Color Print accetta un nuovo parametro
printer_brandche scrive un preset dello slicer corrispondente nel 3MF, in modo che il file si apra pronto per la stampa su stampanti Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker e AnkerMake, oltre a Bambu Lab (il valore predefinito). La pagina ora documenta anchemax_depth.
Sep 18
- Aggiunto
meshy-7.1come valore diai_modelper Immagine in 3D, Multi-immagine in 3D e Testo in 3D: stessi parametri e stesso costo in crediti dimeshy-7, maggiore dettaglio della geometria.latestora corrisponde ameshy-7.1;meshy-7è deprecato ma continua a funzionare senza modifiche. - Aggiunto
geometry_resolution(standard/2k/4k) alle stesse API, in sostituzione del parametro ora deprecatoultra_mode(ultra_mode: truecontinua a funzionare ed equivale a"2k").4krichiede Meshy 7.1 (meshy-7.1olatest), non è disponibile per Multi-immagine in 3D, e costa gli stessi 5 crediti extra di2k.
Sep 16
- L'API Auto Split ora accetta un
input_task_idcon texture. In precedenza lo rifiutava con400, il che significava dover generare la stessa mesh una seconda volta conshould_texture: falseper poterla dividere. Una divisione taglia la geometria e ricostruisce le superfici di ogni parte, quindi la texture dell'input non viene riportata e il risultato è un modello senza texture con un colore piatto per ogni parte. Questo era già vero per ogni divisione e non è cambiato. meshy-5verrà ritirato il 10 ottobre 2026. Non è più documentato come valore diai_modelper Testo in 3D, Immagine in 3D, Multi-immagine in 3D o Retexture, e dopo il 10 ottobre le richieste che invianoai_model: "meshy-5"restituiranno un errore.- La chiave API in modalità test condivisa è stata ritirata; le richieste che la inviano ancora ora restituiscono
401 Unauthorized. Se l'hai copiata nel tuo codice o nella CI, sostituiscila con la tua chiave personale dalla pagina delle API Keys. Quella chiave restituiva sempre lo stesso modello di esempio indipendentemente dall'input, quindi non ha mai mostrato cosa avrebbe effettivamente generato una richiesta. Per vedere cosa restituisce l'API prima di sviluppare basandoti su di essa, usa il Playground nella Developer Platform, che esegue un task reale nel tuo browser. Sui piani senza accesso API, esegue Immagine in 3D senza chiave API e utilizza i crediti del tuo account come qualsiasi altro task.
Sep 15
- Aggiunti
gpt-image-2-5-flareegpt-image-2-5-sunburstai valori documentati diai_modelper le API Testo in immagine e Immagine in immagine. Si tratta dei livelli OpenAI GPT Image 2.5, con prezzo identico agpt-image-2(Testo in immagine: 9 crediti; Immagine in immagine: 12 crediti). - I modelli GPT Image (
gpt-image-2,gpt-image-2-5-flare,gpt-image-2-5-sunburst) ora accettano anche i rapporti d'aspetto4:3e3:4nelle API Testo in immagine e Immagine in immagine, oltre a1:1,16:9,9:16,3:2e2:3.
Sep 14
- L'API Immagine in immagine ora accetta
input_task_id, così puoi concatenare direttamente un'attività Testo in immagine o Immagine in immagine già completata invece di copiare i suoi URL di output inreference_image_urls.
Sep 11
- Cambiamento di comportamento: la
DELETEsu un'attività già in statoIN_PROGRESSora viene rifiutata con409 Conflict, e l'attività continua a essere eseguita. In precedenza restituiva200 OK, interrompeva il worker e scartava il risultato, ma manteneva i crediti poiché solo le attivitàPENDINGsono rimborsabili. La chiamata ti costava sia il modello sia i crediti, senza che nulla nella risposta lo segnalasse. Se la tua integrazione elimina le attività per annullarle, tieni presente che un'attività già avviata dal worker non può essere annullata. AttendiSUCCEEDED,FAILEDoCANCELED, quindi eliminala. Le attivitàPENDINGvengono ancora eliminate e rimborsate esattamente come prima, e le attività in stato terminale vengono comunque eliminate. Si applica a ogni famiglia di attività sotto/openapi. Vedi Errori. - Aggiunto
meshy-6-liteai valori documentati diai_modelper le API Testo in 3D, Immagine in 3D, Multi-immagine in 3D e Retexture. È il successore dimeshy-5: stessi parametri, stesso costo in crediti (5 per la mesh, 15 con texture, 10 per una retexture). meshy-5è ora deprecato in tutte le API che lo accettano. Continua a funzionare e nulla cambia nella tua richiesta o nel tuo conto, ma smetterà di accettare nuovo traffico in una futura versione. Se la tua integrazione inviaai_model: "meshy-5", esegui la migrazione ameshy-6-lite.
Sep 9
- Nuova API Auto Split: suddivide un modello Meshy 6 o Meshy 7 non texturizzato in parti stampabili separatamente. La suddivisione avviene automaticamente, in base alle parti nominate (
by_parts), oppure per regione di colore (by_color), con connettori a tenone e mortasa opzionali e rinforzo delle pareti sottili. Esporta ogni parte come oggetto a sé stante inglb,obj,fbx,usdz,blendo3mf, assemblata oppure disposta sul piano di stampa (layout). 10 crediti per attività.
Sep 7
- Aggiunto il parametro
name_textalla fase di prototipazione della API Creative Lab Keychain: incidi un nome fino a 10 caratteri sul portachiavi, la stessa personalizzazione offerta dall'app web. La fase di build eredita automaticamente l'incisione, e l'oggetto dell'attività di prototipazione ora restituiscename_textin modo da poter confermare il testo esatto prima della build.namerimane un'etichetta dell'attività solo a scopo di visualizzazione e non viene incisa.
5 set
- Aggiunta l'API Creative Lab Fidget Pixel: trasforma una foto in una tavola fidget pixel-art multicolore stampabile in 3D, in due fasi.
POST /prototype(6 crediti) pixelizza la foto trasformandola in un'immagine pixel-art. Passatypecomepersonootherper scegliere lo stile di pixelizzazione.POST /build(30 crediti) la campiona su una griglia16o32e trasforma ogni pixel in un pezzo incastrabilesquareohex, fornito come un unico file 3MF con tag colore per la stampa multi-filamento. La geometria dei pezzi è regolabile tramitepiece_size_mm,color_countepiece_height_mm.
Sep 4
- Aggiunto
GET /openapi/v1/animations/libraryalla Libreria animazioni: recupera ogni azione preimpostata accettata dalla Animation API (action_id, nome, categoria e un'anteprima GIF animata) con filtri di ricerca e categoria, così puoi costruire il tuo selettore di azioni personalizzato invece di consultare la tabella di riferimento. Gratuito; non consuma crediti. - Aggiunta la Creative Lab Collapsible Fidget API: trasforma una foto in un fidget toy pieghevole stampabile in un unico pezzo, in cui la sagoma del soggetto diventa una serie di anelli concentrici annidati che si comprimono in piano e si estendono di nuovo, stampato in un solo pezzo senza bisogno di assemblaggio. Una singola
POSTporta l'immagine fino al modello finito. Non esiste una coppia di fasi prototipo/build e non ci sono parametri di geometria da regolare. Ogni task costa 6 crediti e restituisce sia un file STL stampabile sia un GLB per l'anteprima.
Sep 3
- La fase di prototipo delle Creative Lab Lamp API ora restituisce un modello 3D.
POST /prototypetrasforma l'immagine concettuale in un paralume cavo in GLB, e l'oggetto task del prototipo acquisiscemodel_urls.glbethumbnail_urlaccanto aimage_urls. La fase di build esegue solo il processore della lampada su quel modello e ora produce un paralume con fondo aperto dotato di una base per il dispositivo della sorgente luminosa. I Prezzi si adeguano al lavoro. Il prototipo costa 30 crediti e la build 6 crediti (in precedenza 6 e 30). Il parametrotextdel prototipo è stato rimosso, eimage_urlè ora obbligatorio.
2 settembre
- La Animation API ora accetta
action_ids, così puoi applicare fino a 10 azioni preimpostate a un personaggio riggato in un'unica richiesta e ricevere un singolo file contenente una clip di animazione per ogni azione, pronto per essere utilizzato da una macchina a stati in un motore di gioco. Le clip mantengono l'ordine in cui le elenchi e riportano il nome della libreria dell'animazione. Costa 3 crediti per azione, epost_processsi applica al file unito. Consulta il Riferimento della Libreria animazioni per gli id disponibili e la tabella dei prezzi.
Sep 1
- Aggiunto il parametro
ultra_modealla Multi-immagine in 3D API: abilita la generazione Ultra suai_modelmeshy-7(olatest) per una geometria di qualità superiore con dettagli di superficie più fini, al costo di 5 crediti extra. È lo stesso passaggio Ultra offerto dalla Immagine in 3D API, ora disponibile anche con input multi-vista. - Rimosso
meshy-t1dai valori documentati diai_modelper ilmodel_typeSmart Topology della Immagine in 3D API. Smart Topology ora documenta solomeshy-t2; le nuove integrazioni dovrebbero utilizzare quest'ultimo. Meshy T1 è previsto per la deprecazione. Se la tua integrazione invia attualmenteai_model: "meshy-t1", esegui la migrazione ameshy-t2.
Agosto 2026
Aug 28
- Aggiunta la Usage API per i team Studio ed Enterprise: esporta programmaticamente lo storico di utilizzo delle task API (endpoint, stato, timestamp, la chiave API che ha eseguito ciascuna task e
consumed_credits) con paginazione standard e filtri per intervallo temporale, endpoint e stato, per il monitoraggio dei costi e i sistemi finanziari.
Aug 26
- La Animation API ora accetta
motion_task_id, così puoi applicare una clip di movimento generata con la Text to Motion API al tuo personaggio bipede con rig, come alternativa a unaction_idpreimpostato. Sempre 3 crediti per task.
Aug 24
- Espanso il supporto per
aspect_ratiodigpt-image-2sulle API Testo in immagine e Immagine in immagine per aggiungere16:9e9:16.gpt-image-2ora accetta1:1,16:9,9:16,3:2e2:3;4:3e3:4restano non supportati per questo modello.
Aug 21
- Aggiunta la Text to Motion API: genera una clip di movimento di un personaggio a partire da una descrizione in linguaggio naturale, senza bisogno di un modello di personaggio. Scegli il mode
prime(10 crediti, output FBX) per la qualità più alta o il modeswift(3 crediti, output BVH) per una generazione rapida ed economica, con durate della clip da 2 a 10 secondi.
Aug 20
- Aggiunto il parametro
stylealla Multi-Color Print API: sceglirealistic(predefinito) per colori fedeli alla texture, oppurecartoonper regioni di colore piatte e uniformi e un 3MF più piccolo. - Aggiunto il parametro
remove_backgrounda ogni endpoint di prototipo Creative Lab: Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet e Lamp. Impostaremove_background: trueper ricevere l'immagine del prototipo come PNG RGBA trasparente con lo sfondo rimosso.
Aug 18
- Aggiunto il parametro
texture_image_urlsalla Multi-immagine in 3D API: fornisci da 1 a 4 immagini dello stesso oggetto per guidare la texture, invece del singolotexture_image_url. Richiedeai_modelmeshy-7olatest, ed è indipendente daimage_urls. Le due liste possono contenere immagini diverse e un numero diverso di immagini.
Aug 17
- Aggiunto il parametro
remove_backgroundalla Testo in immagine API e alla Immagine in immagine API. Impostaremove_background: trueper ricevere l'immagine generata come un PNG RGBA trasparente con lo sfondo rimosso.
Aug 13
- Aggiunto
ai_model: "meshy-7"alla API Testo in 3D: il nostro più recente modello di generazione 3D, con una geometria di qualità superiore rispetto a Meshy 6. Introduce inoltre il parametroultra_modesul task di preview, che abilita la generazione Ultra per un dettaglio di superficie ancora più fine, al costo di 5 crediti extra. Per applicare la texture con Meshy 7, passaai_model: "meshy-7"sul task di refine oppure ometti del tuttoai_model. - Aggiunto il
model_typeSmart Topology alla API Testo in 3D. Impostamodel_type: "smart-topology"per generare conmeshy-t2: topology più pulita, parti separate in modo nativo, output in triangoli e un numero di facce impostabile contarget_polycount(da 100 a 15.000, valore predefinito 4.000). Una preview Smart Topology costa 5 crediti invece di 20; consulta Prezzi. Ilmodel_type: "lowpoly"esistente è ora deprecato ma continua a servire il traffico per garantire la compatibilità con le versioni precedenti.
Aug 12
- Aggiunto
ai_model: "meshy-7"alle API Immagine in 3D: il nostro più recente modello di generazione 3D, con una geometria a fedeltà più elevata rispetto a Meshy 6. Introduce inoltre il parametroultra_mode, che abilita la generazione Ultra per un dettaglio superficiale ancora più fine. - Aggiunto
ai_model: "meshy-7"alle API Multi-immagine in 3D: il modello di generazione multi-vista di Meshy, che si basa su tutte le viste di input fornite insieme e da esse guida la texturizzazione. - Aggiunto
ai_model: "meshy-7"alle API Retexture: il nostro più recente modello di texturizzazione, con un dettaglio superficiale più nitido e materiali PBR più puliti rispetto a Meshy 6. Introduce inoltre il parametromultiview_image_urls. Fornisci da 1 a 4 viste ordinate dello stesso oggetto per guidare la texturizzazione multi-vista.
Aug 4
- Supporto esteso per l'input
model_urla.glb,.gltf,.obj,.fbx,.stlper gli endpoint Analizza stampabilità e Ripara stampabilità (in precedenza.glb,.stl,.obj). La riparazione restituisce l'asset riparato nel suo formato di input.
July 2026
Jul 27
- Nuova Creative Lab Brick Figure API: trasforma una foto in una statuina 3D da collezione in stile mattoncino. Utilizza lo stesso flusso di lavoro a due fasi dell'API Figure.
prototype(6 crediti) genera un'immagine concettuale stilizzata, ebuild(30 crediti) la trasforma in un modello 3D texturizzato con output GLB e OBJ + MTL. Consulta Prezzi per la ripartizione completa.
Jul 22
- Nuova Creative Lab Keycap API: trasforma una foto in un tasto per tastiera meccanica personalizzato a colori. Utilizza un flusso di lavoro in due fasi.
prototype(12 crediti) genera un rendering del design del tasto finito, poibuild(50 crediti) trasforma il design scelto (concandidate_id) in un modello 3D del tasto con texture, con output in bundle GLB e OBJ, esportato in scala millimetrica reale. Attualmente supporta la base standard Cherry MX 1u (cherry-mx-1x1-r1); sono previste altre dimensioni standard. Consulta Prezzi per la ripartizione completa.
Jul 21
- Ora supportiamo texture base color a 8K tramite un nuovo parametro
texture_resolution(2k/4k/8k) sugli endpoint Immagine in 3D, Multi-immagine in 3D, Testo in 3D Refine e Retexture. A8k, le mappe PBR vengono generate a 4K e non viene prodotta alcuna mappa di emissione. La generazione di texture a 8K costa 15 crediti (2k/4krestano a 10). Vedi Prezzi. - Il booleano
hd_textureè deprecato a favore ditexture_resolution. È ancora supportato ed equivale atexture_resolution: "4k"per retrocompatibilità.
20 lug
- Nuova Creative Lab Vinyl Figure API: trasforma una foto in una statuina 3D da collezione in vinile dalla testa grande. Utilizza lo stesso flusso di lavoro a due fasi della Figure API.
prototype(6 crediti) genera un'immagine concettuale stilizzata, mentrebuild(30 crediti) la trasforma in un modello 3D con texture e output GLB e OBJ + MTL. Consulta Prezzi per il dettaglio completo.
13 lug
- Aggiunto un nuovo
model_typeSmart Topology all'API Immagine in 3D, che offre due modelli tramiteai_model:meshy-t1(l'attuale modello low-poly) emeshy-t2(un nuovo modello con topology più pulita, parti separate in modo nativo, output in triangoli e un numero di facce impostabile tramitetarget_polycount).meshy-t2è il valore predefinito sottosmart-topology. L'esistentemodel_type: lowpolyè ora deprecato ma continua a servire il traffico per garantire la compatibilità con le versioni precedenti.
Jul 7
- Aggiunto il parametro
aspect_ratioall'API Immagine in immagine, per poter controllare il rapporto dell'immagine di output durante la modifica. I valori consentiti sono1:1,16:9,9:16,4:3,3:4per i modelli nano-banana e1:1,3:2,2:3pergpt-image-2. Opzionale; il valore predefinito è1:1e non può essere combinato congenerate_multi_view.
June 2026
Jun 17
- Nuova pagina di documentazione API Playground: una console interattiva per provare gli endpoint senza scrivere codice, e copiare poi il cURL, Python o JavaScript equivalente. Disponibile nei piani Pro, Premium, Ultra, Studio ed Enterprise.
15 giu
- Nuova API Unwrap UV: genera un layout UV di alta qualità per un modello 3D esistente (il passaggio preliminare prima della texturizzazione, o ogni volta che è necessario un layout UV pulito e senza sovrapposizioni per strumenti a valle). Accetta un
input_task_id(un'attività completata di Immagine in 3D, Testo in 3D o Remesh) oppure unmodel_url(solo.glb) e restituisce un "modello bianco UV" con coordinate UV completamente nuove. 5 crediti per chiamata. Supporta mesh fino a 40.000 facce (esegui prima Remesh se la mesh è più grande); le mesh con quadrilateri e n-gon vengono triangolate durante la generazione UV.
Jun 12
- Aggiornato il prezzo di Build dell'API Creative Lab a 30 crediti per chiamata per Keychain, Fridge Magnet e Figure (in precedenza 20). Lamp rimane invariato a 30 crediti. Il prezzo di Prototype rimane invariato a 6 crediti per immagine. Consulta Pricing per il dettaglio completo.
Jun 5
- Aggiunto il parametro opzionale
alpha_thumbnailalle API Image to 3D, Multi-Image to 3D, Text to 3D, Retexture, Remesh e Repair Printability. Quando impostato sutrue, il task genera inoltre una versione con sfondo trasparente (RGBA) dell'anteprima e la restituisce nel nuovo campo di rispostaalpha_thumbnail_url. Il campothumbnail_urlesistente rimane invariato. Il valore predefinito èfalse.
Jun 1
- Nuove API Creative Lab: una famiglia di endpoint specifici per prodotto che trasformano una foto sorgente (o un prompt testuale) in un prodotto di consumo stampabile in 3D. Quattro prodotti al lancio: Keychain, Fridge Magnet, Figure e Lamp. Ognuno segue un flusso di lavoro a due fasi
prototype→buildconcatenato tramiteinput_task_id, servito tramite URL specifici per prodotto (/openapi/creative-lab/<product>/v1/...) con versionamento per singolo prodotto, in modo che ciascun prodotto possa evolvere su linee di versione indipendenti. Prototype: 6 crediti per chiamata. Build: 30 crediti per chiamata.
Maggio 2026
May 26
- Aggiunto il parametro
multi_view_thumbnailsall'API Multi-immagine in 3D. Quando impostato sutrue, il task genera inoltre quattro thumbnail con viste cardinali (fronte, destra, retro, sinistra) e le restituisce nel nuovo campo di rispostathumbnail_urls. Il campo esistentethumbnail_urlrimane invariato. Aggiunge circa 3 secondi alla latenza del task.
May 22
- Le funzionalità di conversione e ridimensionamento della Remesh API sono ora disponibili come endpoint indipendenti Convert API e Resize API. I parametri deprecati su Remesh continueranno a funzionare per garantire la retrocompatibilità.
13 maggio
- Aggiunto il parametro
multi_view_thumbnailsall'API Immagine in 3D. Quando impostato sutrue, l'attività genera inoltre quattro miniature con viste cardinali (fronte, destra, retro, sinistra) e le restituisce nel nuovo campo di rispostathumbnail_urls. Il campo esistentethumbnail_urlrimane invariato. Aggiunge circa 3 secondi alla latenza dell'attività.
12 maggio
- Aggiunto il parametro
resize_longest_sideall'API Remesh. Ridimensiona il modello in modo che la dimensione più lunga del bounding box sia uguale al valore specificato in metri. Reciprocamente esclusivo conresize_heighteauto_size.
11 maggio
- Parametro
symmetry_modedeprecato negli endpoint Testo in 3D, Immagine in 3D e Multi-immagine in 3D. Questo parametro non influisce più sull'output.
7 maggio
- Nuova API Analizza stampabilità: analizza un task Meshy completato con successo, o qualsiasi URL di modello 3D, per verificarne la predisposizione alla stampa 3D FDM. Pattern asincrono di creazione + streaming: la POST restituisce un task_id, poi la GET / lo stream SSE restituiscono le metriche di watertightness, volume, fori e spigoli non manifold quando lo stato è SUCCEEDED. Gratuita, non consuma crediti.
- Nuova API Ripara stampabilità: ripara un modello 3D per la stampabilità FDM, correggendo spigoli non manifold, facce degenerate, fori e altri problemi di topology. Accetta un
input_task_iddi Meshy esistente oppure unmodel_url(.glb,.stl,.obj). Il formato di output corrisponde a quello dell'input. 10 crediti per task.
April 2026
Apr 27
- Aggiunto il campo
consumed_creditsa tutte le risposte dei task su ogni endpoint dell'API. Mostra il numero di crediti consumati da ciascun task. Il campo è presente per i task negli statiPENDING,IN_PROGRESSeSUCCEEDED. Restituisce0per i taskFAILED(i crediti vengono rimborsati automaticamente in caso di errore). Consulta Prezzi per i costi in crediti per endpoint.
Apr 24
- Aggiunto il parametro
model_urlall'endpoint Multi-Color Print. Invia direttamente un modello 3D con texture (tramite URL o Data URI) invece di uninput_task_idproveniente da un task Meshy precedente. Formati supportati:.glb,.fbx. Quando vengono forniti siamodel_urlcheinput_task_id,input_task_idha la priorità.
21 apr
- Aggiunto il parametro
input_task_idagli endpoint Immagine in 3D e Multi-immagine in 3D. Fa riferimento direttamente all'output di un task Testo in immagine o Immagine in immagine completato, invece di fornireimage_url/image_urls. Quando vengono forniti entrambi,input_task_idha la priorità.
20 apr
- Aggiunto il parametro
hd_textureagli endpoint Immagine in 3D, Multi-immagine in 3D, Testo in 3D Refine e Retexture. Se abilitato, la texture del colore base viene generata a una risoluzione di 4K (4096×4096) per un dettaglio maggiore. Supportato solo permeshy-6elatest. Il valore predefinito èfalse. - Il pacchetto PBR restituito quando
enable_pbrètrueora include una mappaemissionall'interno ditexture_urlsper i taskmeshy-6elatestnegli endpoint Immagine in 3D, Multi-immagine in 3D, Testo in 3D Refine e Retexture. Non è richiesta alcuna modifica alla richiesta.
14 apr
- Aggiunto il parametro
decimation_modeagli endpoint Immagine in 3D, Multi-immagine in 3D, Testo in 3D Preview e Remesh. Imposta il livello di conteggio poligoni per la decimazione adattiva:1(ultra),2(alto),3(medio) o4(basso).
12 apr
- Ristrutturata la documentazione API: aggiunto il raggruppamento dei parametri con campi dipendenti, valori predefiniti inline, badge per obbligatorio/deprecato, sotto-navigazione espandibile, e suddivise le pagine di Multi-immagine, Rigging e Animazione in pagine separate.
Marzo 2026
Apr 2
- Aggiunto il supporto per il formato
3mfal parametrotarget_formatssu tutti gli endpoint (Immagine in 3D, Testo in 3D, Remesh, Retexture). Nota: il 3MF è disponibile solo su richiesta esplicita (opt-in). - Nuova Multi-Color Print API: Converti modelli 3D nel formato 3MF multicolore per la stampa 3D. Supporta palette da 1 a 16 colori con precisione configurabile. 10 crediti per attività.
Mar 20
- Ritirato il modello AI Meshy-4. Tutte le richieste API che utilizzano
meshy-4non sono più supportate. Esegui la migrazione ameshy-6olatest. - Aggiunti i parametri
auto_sizeeorigin_atagli endpoint Immagine in 3D, Multi-immagine in 3D, Testo in 3D e Remesh. Quandoauto_sizeè abilitato, il servizio utilizza la visione artificiale per stimare l'altezza reale e ridimensionare automaticamente il modello.origin_atimposta la posizione dell'origine (bottomocenter). Nell'API Remesh,auto_sizeè mutuamente esclusivo conresize_height.
17 mar
- Aggiunto il parametro opzionale
target_formatsagli endpoint Immagine in 3D, Multi-immagine in 3D, Testo in 3D e Retexture. Specifica quali formati 3D generare (ad esempio,["glb", "fbx"]) per ridurre i tempi di completamento delle attività.
Febbraio 2026
28 feb
- Aggiunto il parametro
remove_lightingalle API Immagine in 3D, Multi-immagine in 3D, Testo in 3D Refine e Retexture. Rimuove luci e ombre dalla texture del colore di base per risultati più puliti con illuminazione personalizzata. Supportato solo permeshy-6elatest. Il valore predefinito ètrue. - Le API Retexture e Testo in 3D Refine ora supportano
meshy-6come valore diai_modelper la texturizzazione completa con Meshy 6.
Feb 25
- Aggiunto il parametro
image_enhancementalle API Immagine in 3D e Multi-immagine in 3D per gli utenti che desiderano escludere l'ottimizzazione dell'immagine di input e preservare l'aspetto esatto del proprio input. Supportato solo permeshy-6elatest. Il valore predefinito ètrue.
Feb 20
- Aggiunto il parametro
model_typeall'API Text to 3D Preview per generare mesh low-poly ottimizzate per poligoni più puliti.
Gennaio 2026
Jan 27
- Aggiunta documentazione dettagliata sui Failure Modes per tutti gli endpoint API, inclusi i codici di errore HTTP comuni (400, 401, 402, 404, 422, 429) e i motivi di fallimento dei task. Questo aiuta gli sviluppatori a comprendere e gestire meglio gli errori delle API.
Jan 26
- L'API Multi-immagine in 3D ora supporta Meshy-6 per la generazione mesh completa. Il parametro
ai_modelora accettameshy-6elatestsi risolve in Meshy 6.
22 gennaio
- Deprecato
art_styleper l'API Anteprima Testo in 3D (Meshy-6). Il parametro era stato progettato per i modelli Legacy (Meshy-4 / Meshy-5) e verrà rimosso in una futura versione. - Deprecato
enable_pbrper le API Testo in 3D e Immagine in 3D quandoai_modelèmeshy-4. Questo parametro verrà rimosso in una futura versione. - Aggiornato il valore predefinito del parametro
should_remeshper Meshy-6 nelle API Testo in 3D e Immagine in 3D. Il parametro ora ha come valore predefinitofalsepermeshy-6, etrueper gli altri modelli se non specificato.
Jan 19
- L'opzione
latestperai_modelnelle API Testo in 3D (Preview) e Immagine in 3D ora fa riferimento a Meshy 6.
Jan 12
- Aggiunto un nuovo parametro
model_typeall'API Immagine in 3D per generare mesh low-poly ottimizzate per poligoni più puliti.
Dicembre 2025
Dec 31
- Lanciato l'API Playground, uno spazio dedicato per gli sviluppatori per esplorare i parametri delle API e testare le richieste direttamente sul sito web di Meshy.
- Introdotte le API Testo in immagine e Immagine in immagine, che consentono la generazione di immagini basata su AI a partire da prompt testuali e la modifica di immagini a partire da immagini di riferimento. Entrambe le API supportano i modelli
nano-bananaenano-banana-pro, con generazione Multi-vista opzionale.
Dec 22
- Il campo
video_urlnella risposta dell'API Testo in 3D è ora deprecato e verrà rimosso in una versione futura.
Dec 04
- Aggiunto un nuovo parametro
pose_modealle API Text to 3D Preview, Immagine in 3D e Multi-immagine in 3D. Questo parametro accettaa-pose,t-pose, oppure una stringa vuota (valore predefinito). Il parametrois_a_t_poseè ora deprecato a favore dipose_mode.
Novembre 2025
Nov 24
- Le API Immagine in 3D e Multi-immagine in 3D aggiungono un parametro opzionale
save_pre_remeshed_modeled espongonomodel_urls.pre_remeshed_glbquando viene richiesto un backup pre-remesh.
Nov 06
- L'API Testo in 3D Refine ora supporta
ai_model = latest, che corrisponde a Meshy 6 Preview. - L'API Immagine in 3D ora utilizza per impostazione predefinita la texturizzazione Meshy-6-preview quando
ai_model = latesteshould_texture = true. - L'API Multi-immagine in 3D ora supporta
ai_model = latest, eseguendo Meshy-6-preview per la texturizzazione per impostazione predefinita, mentre la generazione della mesh rimane Meshy-5. - L'API Retexture aggiunge un'opzione
latestperai_model(Meshy-6-preview) e ora la utilizza come valore predefinito quando omessa.
Nov 04
- L'API Remesh ora preserva le texture per i modelli caricati.
- L'API Retexture ora preserva le texture per i modelli caricati quando è abilitata l'opzione
enable_original_uv.
Ottobre 2025
Oct 28
- Aggiunta l'intestazione di risposta
x-api-versionper indicare la versione corrente del server API.
Oct 20
- Aggiunto il parametro booleano opzionale
convert_format_onlyall'API Remesh per supportare la sola conversione del formato del file del modello in ingresso. - Aggiunto
rigged_character_glb_urlalla risposta di The Rigging Task Object.
Oct 01
- Rimozione delle API
text-to-voxel
Settembre 2025
Sep 23
- Aggiunta un'opzione
latestperai_modelnell'API Testo in 3D per utilizzare Meshy 6 Preview. - Sconto temporaneo del 50% in vigore per le attività di generazione Meshy-6-preview, portate a 10 crediti, valido fino al 30 settembre 2025. Al termine del periodo di sconto, il costo delle attività Meshy-6-preview tornerà al valore normale di 20 crediti.
Sep 18
- Aggiornati i prezzi delle API per Testo in 3D e Immagine in 3D per riflettere i diversi costi di Meshy 6 e degli altri modelli.
16 set
- Aggiunta un'opzione
latestperai_modelnell'API Immagine in 3D per utilizzare Meshy 6 Preview.
4 set
Agosto 2025
18 ago
- Aggiunto un parametro opzionale
is_a_t_posealle API Testo in 3D Preview, Immagine in 3D e Multi-immagine in 3D per generare modelli in posa A/T.
13 Ago
- Meshy 5 è ora stabile per Testo in 3D e Immagine in 3D (
ai_model:meshy-5), offrendo qualità e coerenza migliorate.
Luglio 2025
31 Lug
- Supporto per le mappe texture PBR nell'API tramite il parametro
enable_pbrper l'ultimo modellomeshy-5per gli endpoint Testo in 3D, Immagine in 3D, Multi-immagine in 3D e Retexture.
Giugno 2025
Jun 25
- Aggiunta la API di Retexture, che consente agli utenti di eseguire il retexture dei modelli 3D basandosi sugli ultimi modelli AI fondazionali di Meshy.
Jun 19
- Aggiunte le API di eliminazione per Testo in 3D, Immagine in 3D, Remesh, Rigging e Animazione.
- Aggiunto il parametro
ai_modelalla API di Text to 3D Refine.
Jun 17
- Aggiunta la documentazione per Webhooks.
Jun 10
- L'API Remesh ora supporta modelli GLB codificati in base64 nel parametro
model_urltramite una Data URI.
May 2025
May 20
- Aggiunto un parametro opzionale
moderationalle API Testo in 3D Preview, Testo in 3D Refine, Immagine in 3D e Multi-immagine in 3D. Se abilitato, il contenuto in ingresso viene automaticamente controllato per individuare eventuali contenuti potenzialmente dannosi prima della generazione.
15 maggio
- Introdotta l'API Auto-rigging & Animazione, che consente agli utenti di eseguire automaticamente il rigging e l'animazione dei modelli 3D. Scopri di più sul Rigging e sull'Animazione.
Aprile 2025
29 apr
- Introdotta la API Multi-immagine in 3D, che consente di generare modelli 3D da 1 a 4 immagini di input utilizzando il modello AI
meshy-5. - Aggiunta l'opzione del modello AI
meshy-5alle API Testo in 3D e Immagine in 3D. Il taglatestora corrisponde anch'esso ameshy-5.
Apr 17
- Aggiunto il parametro
texture_image_urlalle API Immagine in 3D e Testo in 3D Refine, permettendo agli utenti di guidare il processo di generazione delle texture tramite un'immagine.
Marzo 2025
Mar 28
- Aggiunto il parametro
latestalle API Testo in 3D e Immagine in 3D, per consentire l'accesso ai nostri futuri modelli AI avanzati per una qualità di generazione migliorata.
Mar 14
- L'API Testo in texture ora supporta modelli codificati in base64 nel parametro
model_urltramite un Data URI, in modo simile alimage_urlnell'API Immagine in 3D.
Mar 06
- Aggiornati i prezzi per le attività di generazione tramite API:
- Testo in 3D (Preview): aumentato da 2 a 5 crediti per chiamata
- Testo in 3D (Refine): aumentato da 5 a 10 crediti per chiamata
- Immagine in 3D: ora 5 crediti senza texture, 15 crediti con texture
- Testo in texture: aumentato da 5 a 10 crediti per chiamata
- Text to Voxel: resta a 5 crediti per chiamata
Febbraio 2025
Feb 18
- Aggiunta una chiave API in modalità test che consente agli sviluppatori di testare l'integrazione API senza consumare crediti. Tutte le richieste valide che utilizzano questa chiave restituiranno gli stessi risultati di task di esempio.
Feb 13
-
Modifiche sostanziali:
- La creazione di task nel piano gratuito terminerà il
20 marzo 2025. Successivamente, tutte le richieste di task API richiederanno un abbonamento a pagamento. Per mantenere un accesso senza interruzioni, consigliamo di effettuare l'upgrade prima della scadenza. - Usa il codice coupon
APIACCESSper usufruire di uno sconto del40%. Grazie per essere con noi!
- La creazione di task nel piano gratuito terminerà il
-
Aggiunti endpoint di streaming Server-Sent Events (SSE) per aggiornamenti dei task in tempo reale:
Feb 6
- Aggiunto il parametro
texture_promptalle API Immagine in 3D e Testo in 3D Refine, che consente agli utenti di guidare il processo di generazione delle texture con un prompt testuale.
January 2025
Jan 23
- Aggiunti endpoint per l'elenco delle attività alle API Testo in 3D, Immagine in 3D, Remesh e Testo in texture.
Jan 14
- Deprecato le API legacy di Testo in 3D e Immagine in 3D basate sui modelli AI Meshy-3.
Jan 07
- Aggiunto il parametro
symmetry_modealle API Text to 3D Preview e Image to 3D, consentendo impostazioni di simmetria configurabili.
Dicembre 2024
Dec 19
- Aggiunte le API Remesh, che consentono agli utenti di eseguire il remesh ed esportare modelli 3D esistenti generati da altre API Meshy in vari formati.
- Aggiornati i limiti di conteggio poligoni per le nostre API a un intervallo compreso tra 100 e 300.000 per gli utenti Premium.
Dec 12
- Deprecata la proprietà
model_urlin tutti gli oggetti di risposta. - Separata l'API Legacy di Meshy-3 dall'ultima API di Meshy-4.
Dec 10
- Aggiunto un parametro
enable_pbralle API Immagine in 3D e Testo in 3D Refine. - Aggiunto un parametro
should_textureall'API Immagine in 3D. - Deprecata l'opzione
pbrnel parametroart_styleper l'API Testo in 3D Preview quando si utilizza il modello AImeshy-4. - Deprecata l'opzione
low-polynel parametroart_styleper l'API Testo in 3D Preview.
Dec 5
- Aggiunta una Get Balance API per consentire agli utenti di recuperare il proprio saldo di crediti.
- Aggiunto un parametro
should_remeshalle API Immagine in 3D e Text to 3D Preview.
Dec 3
- Le API esterne ora utilizzano il prefisso
/openapi. I percorsi Legacy continuano a essere supportati, ma si consiglia di passare ai nuovi percorsi.
Novembre 2024
Nov 14
- La Image to 3D API ora supporta immagini codificate in base64.