Changelog
Scopri tutte le novità e gli aggiornamenti più recenti della Meshy API e dei plugin.
Preferisci un feed in tempo reale? Le voci più recenti vengono mostrate anche nella pagina panoramica della Developer Platform.
Novembre 2026
Nov 18
- Aggiunto il rigging per quadrupedi a Rigging. Invia
animation_type: "quadruped"per aggiungere un rig a un animale a quattro zampe. Il rig include un'animazione di camminata e una di corsa. - Animazione applica le animazioni
quadrupeda un rig per quadrupedi, conaction_idoaction_ids. Qualsiasi animazionequadrupedfunziona su qualsiasi rig per quadrupedi. Un rig per quadrupedi e ogni animazione costano come su un rig per bipedi. - List animations restituisce
rig_typeper ogni animazione,bipedoquadruped. Un rig accetta solo animazioni del proprio tipo.
16 nov
- Aggiunti
color_mappingetarget_formatsalla API Rilievo.color_mapping: truecolora i file GLB, OBJ, FBX e USDZ con la foto, mentretarget_formatsaggiunge i file OBJ, FBX, USDZ e 3MF. Il prezzo resta di 20 crediti.
13 nov
- Nuova pagina Meshy CLI: installa il comando
meshy, accedi tramite il browser (oppure con un codice dispositivo su una macchina remota) e genera il tuo primo modello conmeshy make. Copre inoltre l'output JSON e i codici di uscita per gli script, un esempio con GitHub Actions e quando usare la CLI oppure l'MCP server, confronto ora presente anche nella pagina Integrazione AI.
10 nov
- Aggiunto
skeleton_templatea Rigging. Fornisce un personaggio bipede sullo scheletro previsto dal tuo motore o strumento, comemixamooue5_mannequin. Le attività di Animazione utilizzano lo scheletro del rig. Il Rigging v1 ha come impostazione predefinitameshyrig, come in precedenza, mentre il Rigging v2 ha come impostazione predefinitamixamo. - Aggiunto
include_fingersa Rigging. Impostalo sutrueper aggiungere ossa delle dita alle mani di un personaggio bipede, su qualsiasi scheletro. meshy-7verrà ritirato il 31 dicembre 2026 comeai_modeldelle attività di anteprima di Testo in 3D, Immagine in 3D e Multi-immagine in 3D. A partire da quella data, le richieste che invianoai_model: "meshy-7"a questi endpoint restituiranno400. Passa ameshy-7.1, che accetta gli stessi parametri e ha lo stesso costo.meshy-7come modello di texture resta disponibile. Questo copre Retexture,texture_modele l'ai_modeldi un refine di Testo in 3D. Vedi Deprecazioni.
6 Nov
- Aggiunti
gpt-image-2-6-flareegpt-image-2-6-sunburstai valoriai_modeldelle API Testo in immagine e Immagine in immagine. Questi sono i livelli OpenAI GPT Image 2.6: Flare per l'iterazione rapida, Sunburst per il lavoro dettagliato e le modifiche precise. Supportano gli stessi rapporti d'aspetto degli altri modelli GPT Image e costano comegpt-image-2(Testo in immagine: 9 crediti; Immagine in immagine: 12 crediti).
5 novembre
- Nuova API Rilievo: trasforma una singola foto in un modello 3D a bassorilievo (GLB e STL) e in una mappa di profondità in scala di grigi a 16 bit, per stampa 3D, incisione laser e lavorazione CNC. Parametri opzionali consentono di impostare dimensioni, mode e profondità di incisione, base, curvatura e risoluzione della mesh;
should_generate_model: falserestituisce solo la mappa di profondità. 20 crediti per attività.
3 novembre
- Aggiunto
texture_modela Immagine in 3D e Multi-immagine in 3D, per scegliere il modello di texture nella stessa attività della mesh. Immagine in 3D supporta Meshy 7 (meshy-7), Meshy N1 (meshy-n1) e Meshy 6 Lite (meshy-6-lite) con qualsiasiai_model. Multi-immagine in 3D supporta i modelli di texture multi-vista, Meshy 7 e Meshy N1. Ogni modello di texture mantiene i propri limiti; vedi Models. Un'attività costa il prezzo solo-mesh del suoai_modelpiù il prezzo di Retexture alla sua risoluzione di texture; vedi Prezzi. Le richieste senzatexture_modelfunzionano come prima. - Aggiunto
ai_model: "meshy-n1"al refine di Testo in 3D. Senzatexture_image_url, Meshy N1 applica la texture a partire dall'immagine di riferimento memorizzata da un'anteprima Meshy 7.1 olatest. Le altre anteprime richiedonotexture_image_url. Un refine con Meshy N1 costa 10 crediti.
2 Nov
- Aggiunto
ai_model: "meshy-n1"all'API Retexture. Meshy N1 crea una texture base color a 2K da una a quattro immagini di riferimento. Con più di un'immagine, la prima è la vista frontale, mentre l'ordine delle altre non ha importanza, come per Meshy 7. Non accetta prompt testuali, non crea mappe PBR né texture a 4K e 8K, e applica texture a modelli 3D fino a 7.999.999 facce. Un task costa 10 crediti, come un Retexture a 2K; vedi Prezzi.latestcontinua a fare riferimento a Meshy 7.
Ottobre 2026
Oct 30
- Alcune richieste Meshy T1 (
model_type: "lowpoly"oai_model: "meshy-t1") su Testo in 3D e Immagine in 3D ora vengono eseguite su Smart Topology, mentre le restanti restituiscono400.model_type: "smart-topology"conai_model: "meshy-t2.5"sostituisce T1. Dal 30 novembre 2026, ogni richiesta T1 restituirà400. Deprecazioni elenca quali richieste sono ancora supportate. - La API di Auto Split include un nuovo parametro opzionale,
keep_texture. Conkeep_texture: true, ogni parte di un modello con texture mantiene la texture, e il task restituisce le mappe di texture intexture_urls, oltre a un filemtlinsieme a un OBJ. Senza questo parametro, la 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 di refine di Testo in 3D e di Retexture.
26 ott
- Nuova pagina Deprecazioni: 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 API e i parametri deprecati ancora in servizio. Il banner di ritiro sulle pagine API ora rimanda a questa pagina.
23 ott
- Deprecato
texture_image_urlin Rigging. Meshy utilizza le texture incorporate nel filemodel_url, oppure le texture dell'attività di input, quindi ometti questo parametro quando il modello ha texture proprie. Se lo invii, l'immagine diventa l'unica texture del modello riggato e il modello perde le sue mappe PBR.
Oct 21
- Aggiunta l'intestazione
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, ad esempiouser=alex@example.com,team=fab, e leggile successivamente nel campometadatadei record Usage. Vedi Metadata.
Oct 19
export_resolutionora accetta valori fino a512, invece di2048, nei task di build Keychain e Fridge Magnet.512è la risoluzione della mappa di profondità da cui viene costruita la geometria, quindi ogni valore superiore a questo 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 da questa modifica. Un valore superiore a512ora restituisce400al momento della creazione invece di essere accettato. In particolare,2048superava sempre il tempo limite del generatore e falliva dopo che il task era già iniziato. Se hai impostatoexport_resolutionsopra512, rimuovi il parametro oppure impostalo a512.
15 ott
- Aggiunto
ai_model: "meshy-t2.5"alle API Immagine in 3D e Testo in 3D: il più recente modello Smart Topology, 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, per Retexture, Remesh, Rigging, Converti, Ridimensiona, Unwrap UV, Multi-Color Print, Analizza stampabilità e Ripara stampabilità. Un URIdata:rimane a 100 MB. Un file GLB, glTF, FBX o OBJ superiore a 100 MB può avere al massimo 10.000.000 di facce (8.000.000 per Multi-Color Print), contate come triangoli; un file che ne ha di più restituisce400. Oltre i 100 MB, un file FBX deve essere FBX binario 7.1 o versione successiva, 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 è necessario prevedere 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 di403. Un task tuo, o di un collega in uno spazio di lavoro a cui appartieni, funziona come prima.
12 ott
- 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_urlsdelle attività Testo in 3D, Immagine in 3D, Multi-immagine in 3D, Retexture, Remesh, Converti, Ridimensiona e Auto Split ora dichiarametersPerUnit = 1. Fino ad ora dichiarava 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 questa scalatura per le attività create a partire da questa data. I file delle attività 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 gli URL pubblici che per i 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.balancein sé resta invariato.
6 ott
- Analizza stampabilità e Ripara stampabilità possono ora verificare lo spessore parete in base alla dimensione di stampa prevista. Invia
printer_type, una dimensione di stampa, o entrambi. Analizza stampabilità segnala le pareti sottili inprintability.thin_walls, mentre Ripara stampabilità le ispessisce quando necessario, e può 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 release futura. 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 API ora includono header di limite di frequenza, incluso
Retry-Afterper indicare quanto tempo attendere prima di riprovare o effettuare nuovamente il polling. - Multi-Color Print accetta un nuovo parametro
printer_brandche scrive una preimpostazione 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 che Bambu Lab (l'impostazione predefinita). La pagina ora documenta anchemax_depth.
Sep 18
- Aggiunto
meshy-7.1come valoreai_modelper Immagine in 3D, Multi-immagine in 3D, e Testo in 3D: stessi parametri e stesso costo in crediti dimeshy-7, ma con 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 su Multi-immagine in 3D, e costa gli stessi 5 crediti extra di2k.
16 set
- L'API di Auto Split ora accetta un
input_task_idcon texture. In precedenza lo rifiutava con400, il che significava 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 mantenuta e il risultato è un modello senza texture, con un colore piatto per ogni parte. Questo era già vero per ogni divisione e rimane invariato. meshy-5sarà 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 condivisa in modalità test è stata ritirata; le richieste che la inviano ancora ora restituiscono
401 Unauthorized. Se l'avevi 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 mostrava mai 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'attività reale nel tuo browser. Nei piani senza accesso API, esegue Immagine in 3D senza chiave API e utilizza i crediti del tuo account come qualsiasi altra attività.
Sep 15
- Aggiunti
gpt-image-2-5-flareegpt-image-2-5-sunburstai valoriai_modeldocumentati per le API Testo in immagine e Immagine in immagine. Si tratta dei livelli OpenAI GPT Image 2.5, con lo stesso prezzo digpt-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 di aspetto4:3e3:4nelle API Testo in immagine e Immagine in immagine, oltre a1:1,16:9,9:16,3:2e2:3.
Sep 14
- La Image to Image API ora accetta
input_task_id, così puoi concatenare direttamente da un'attività Testo in immagine o Immagine in immagine completata invece di copiare i suoi URL di output inreference_image_urls.
Sep 11
- Modifica di comportamento:
DELETEsu un'attività giàIN_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 che i crediti, senza nulla nella risposta che lo indicasse. Se la tua integrazione elimina le attività per annullarle, tieni presente che un'attività già avviata dal worker non può essere annullata. AttendiSUCCEEDED,FAILEDoCANCELED, poi eliminala. Le attivitàPENDINGvengono ancora eliminate e rimborsate esattamente come prima, e le attività terminali 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 versione futura. Se la tua integrazione inviaai_model: "meshy-5", migra 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 indicate (
by_parts), oppure per regione di colore (by_color), con connettori a incastro maschio-femmina 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 dell'API Creative Lab Keychain: incidi un nome fino a 10 caratteri sul portachiavi, la stessa personalizzazione offerta dall'app web. La fase di produzione eredita automaticamente l'incisione, e l'oggetto dell'attività di prototipazione ora restituiscename_textin modo da poter confermare il testo esatto prima della produzione.nameresta un'etichetta dell'attività solo a scopo di visualizzazione e non viene incisa.
5 set
- Aggiunta la Creative Lab Fidget Pixel API: trasforma una foto in una tavola fidget in pixel-art multicolore stampabile in 3D, in due fasi.
POST /prototype(6 crediti) pixelizza la foto 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, consegnato come un unico 3MF con codifica a colori per la stampa multi-filamento. La geometria dei pezzi è regolabile tramitepiece_size_mm,color_countepiece_height_mm.
4 set
- Aggiunto
GET /openapi/v1/animations/libraryalla Libreria animazioni: recupera ogni azione preimpostata accettata dall'Animation API (action_id, nome, categoria e un'anteprima animata in GIF) con filtri di ricerca e di categoria, così puoi costruire il tuo selettore di azioni invece di leggere 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, dove la sagoma del soggetto diventa una serie di anelli concentrici annidati che si appiattiscono e si allungano di nuovo, stampato in un solo pezzo senza 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 un STL stampabile, oltre a un GLB per l'anteprima quando Meshy è in grado di renderizzarne uno.
Sep 3
- La fase di prototipo dell'API Creative Lab Lamp ora restituisce un modello 3D.
POST /prototypetrasforma l'immagine del concept in un GLB di un paralume cavo, 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 fonte luminosa. I Prezzi si adeguano al lavoro svolto. Il prototipo costa 30 crediti e la build 6 crediti (in precedenza 6 e 30). Il parametrotextdel prototipo è stato rimosso, eimage_urlè ora obbligatorio.
Sep 2
- Le API Animazione ora accettano
action_ids, così puoi applicare fino a 10 azioni preimpostate a un personaggio con rig in un'unica richiesta e ricevere un singolo file contenente una clip di animazione per ogni azione, pronto da gestire da una state machine in un motore di gioco. Le clip mantengono l'ordine in cui le elenchi e portano 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 API Multi-immagine in 3D: abilita la generazione Ultra suai_modelmeshy-7(olatest) per una geometria di qualità superiore con dettagli di superficie più fini, per 5 crediti extra. È lo stesso passaggio Ultra offerto dalla API Immagine in 3D, ora disponibile anche con input multi-vista. - Rimosso
meshy-t1dai valoriai_modeldocumentati per ilmodel_typeSmart Topology della API Immagine in 3D. Smart Topology ora documenta solomeshy-t2; le nuove integrazioni dovrebbero utilizzare quest'ultimo. Meshy T1 è destinato alla 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 API task (endpoint, stato, timestamp, la chiave API che ha eseguito ciascun 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. Stesso costo di 3 crediti per task.
24 Ago
- Ampliato il supporto per
aspect_ratiodigpt-image-2nelle 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.
21 Ago
- Aggiunta la API Text to Motion: genera una clip di movimento per 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 massima qualità oppure 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 texturizzazione, 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.
13 ago
- Aggiunto
ai_model: "meshy-7"alla API di Testo 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_modenel task di preview, che abilita la generazione Ultra per un dettaglio superficiale ancora più fine per 5 crediti aggiuntivi. Per applicare la texture con Meshy 7, passaai_model: "meshy-7"nel task di refine oppure ometti del tuttoai_model. - Aggiunto il
model_typeSmart Topology alla API di 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 retrocompatibilità.
Aug 12
- Aggiunto
ai_model: "meshy-7"a Immagine in 3D API: il nostro più recente modello di generazione 3D, con 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"a Multi-immagine in 3D API: il modello di generazione multi-vista di Meshy, che si basa congiuntamente su tutte le viste fornite in input e le utilizza per guidare la texturizzazione. - Aggiunto
ai_model: "meshy-7"a Retexture API: il nostro più recente modello di texturizzazione, con 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
- Estensione del supporto dell'input
model_urla.glb,.gltf,.obj,.fbx,.stlper gli endpoint Analizza stampabilità e Ripara stampabilità (in precedenza.glb,.stl,.obj). Ripara stampabilità restituisce l'asset riparato nel suo formato di input.
Luglio 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 della Figure API.
prototype(6 crediti) genera un'immagine concettuale stilizzata, ebuild(30 crediti) la trasforma in un modello 3D texturizzato con output in GLB e OBJ + MTL. Consulta Prezzi per il dettaglio completo.
22 lug
- Nuova Creative Lab Keycap API: trasforma una foto in un tasto personalizzato per tastiera meccanica, a colori pieni. Utilizza un flusso di lavoro a due fasi.
prototype(12 crediti) genera un render di design del tasto finito, poibuild(50 crediti) trasforma il design scelto (concandidate_id) in un modello 3D texturizzato del tasto, con output in pacchetto 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 in futuro. Consulta Prezzi per la ripartizione completa.
21 lug
- 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. Viene comunque rispettato ed è equivalente atexture_resolution: "4k"per retrocompatibilità.
20 lug
- Nuova Creative Lab Vinyl Figure API: trasforma una foto in una statuina 3D da collezione in vinile a testa grande. Utilizza lo stesso workflow a due fasi dell'Figure API.
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.
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 a triangoli e un numero di facce impostabile tramitetarget_polycount).meshy-t2è il modello predefinito insmart-topology. L'esistentemodel_type: lowpolyè ora deprecato ma continua a servire il traffico per garantire la retrocompatibilità.
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. Facoltativo; il valore predefinito è1:1e non può essere combinato congenerate_multi_view.
Giugno 2026
Jun 17
- Nuova pagina di documentazione API Playground: una console interattiva per provare gli endpoint senza scrivere codice, per poi copiare l'equivalente in cURL, Python o JavaScript. 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 serve un layout UV pulito e privo di sovrapposizioni per strumenti a valle). Accetta un
input_task_id(un task Immagine in 3D, Testo in 3D o Remesh completato) 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 quad e n-gon vengono triangolate durante la generazione UV.
12 giu
- Aggiornato il prezzo di Build dell'API Creative Lab a 30 crediti per chiamata per Keychain, Fridge Magnet e Figure (in precedenza 20). Lamp resta invariato a 30 crediti. Il prezzo Prototype resta invariato a 6 crediti per immagine. Consulta Prezzi per il dettaglio completo.
5 giu
- Aggiunto il parametro opzionale
alpha_thumbnailalle API Immagine in 3D, Multi-immagine in 3D, Testo in 3D, Retexture, Remesh e Ripara stampabilità. Se 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 campo esistentethumbnail_urlresta invariato. Il valore predefinito èfalse.
1 Giugno
- 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: portachiavi, magnete da frigo, statuina e lampada. Ognuno segue un flusso di lavoro a due fasi
prototype→buildconcatenate tramiteinput_task_id, servite sotto 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 dell'API Remesh sono ora disponibili come endpoint indipendenti API Converti e API Ridimensiona. I parametri deprecati su Remesh continueranno a funzionare per garantire la retrocompatibilità.
13 maggio
- Aggiunto il parametro
multi_view_thumbnailsall'API Immagine in 3D. Se impostato sutrue, l'attività genera inoltre quattro miniature con vista dai punti 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 pari al valore specificato in metri. Mutuamente 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 riuscito, o qualsiasi URL di modello 3D, per verificarne la predisposizione alla stampa 3D FDM. Schema asincrono di creazione + stream: la POST restituisce un task_id, quindi 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 renderlo stampabile in FDM, risolvendo 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.
Aprile 2026
Apr 27
- Aggiunto il campo
consumed_creditsa tutte le risposte dei task su ogni endpoint 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 di ciascun 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à.
Apr 21
- 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 entrambi vengono forniti,input_task_idha la priorità.
Apr 20
- 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 risoluzione 4K (4096×4096) per un maggiore dettaglio. 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 obbligatorio/deprecato, sottonavigazione espandibile, e suddivise Multi-immagine, Rigging e Animazione in pagine separate.
Marzo 2026
Apr 2
- Aggiunto il supporto al formato
3mfal parametrotarget_formatsin tutti gli endpoint (Immagine in 3D, Testo in 3D, Remesh, Retexture). Nota: il 3MF è disponibile solo su richiesta esplicita (opt-in). - Nuova API per la stampa multicolore: Converti i 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. Effettua 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 AI per stimare l'altezza reale e ridimensionare automaticamente il modello.origin_atimposta la posizione dell'origine (bottomocenter). Nell'API Remesh,auto_sizeè reciprocamente esclusivo conresize_height.
17 marzo
- 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 il tempo di completamento del task.
Febbraio 2026
28 febbraio
- 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 Testo in 3D Preview per generare mesh low-poly ottimizzate per poligoni più puliti.
Gennaio 2026
Jan 27
- Aggiunta documentazione dettagliata sulle Modalità di errore 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 dell'API.
Jan 26
- L'API Multi-immagine in 3D ora supporta Meshy-6 per la generazione mesh completa. Il parametro
ai_modelora accettameshy-6elatestcorrisponde a Meshy 6.
22 gen
- 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.
19 gen
- L'opzione
latestperai_modelnelle API Testo in 3D (Preview) e Immagine in 3D ora corrisponde a Meshy 6.
12 gen
- Aggiunto un nuovo parametro
model_typeall'API Immagine in 3D per generare mesh low-poly ottimizzate per poligoni più puliti.
Dicembre 2025
31 dic
- 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 sull'IA 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-poseoppure 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
- La API Testo in 3D Refine ora supporta
ai_model = latest, che corrisponde a Meshy 6 Preview. - La API Immagine in 3D ora utilizza come predefinita la texturizzazione Meshy-6-preview quando
ai_model = latesteshould_texture = true. - La API Multi-immagine in 3D ora supporta
ai_model = latest, eseguendo Meshy-6-preview per la texturizzazione in modo predefinito mentre la generazione mesh rimane Meshy-5. - La API Retexture aggiunge un'opzione
latestperai_model(Meshy-6-preview) e ora la utilizza come predefinita quando omessa.
04 nov
- 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
28 ott
- Aggiunta l'intestazione di risposta
x-api-versionper indicare la versione corrente del server API.
20 ott
- Aggiunto un parametro booleano opzionale
convert_format_onlyall'API Remesh per supportare la conversione del solo formato del file del modello in input. - Aggiunto
rigged_character_glb_urlalla risposta dell'oggetto Rigging Task.
Oct 01
- Rimosse le 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. Dopo il periodo di sconto, il costo delle attività Meshy-6-preview tornerà al normale valore 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.
Sep 16
- Aggiunta un'opzione
latestperai_modelnell'API Immagine in 3D per utilizzare Meshy 6 Preview.
Sep 4
Agosto 2025
Aug 18
- 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 una qualità e una coerenza migliorate.
Luglio 2025
31 lug
- Supporto per le mappe texture PBR nell'API tramite il parametro
enable_pbrper l'ultimo modellomeshy-5, per 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 la 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 Refine per Testo in 3D.
Jun 17
- Aggiunta la documentazione per i Webhooks.
Jun 10
- L'API Remesh ora supporta modelli GLB codificati in base64 nel parametro
model_urltramite un Data URI.
Maggio 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. Quando abilitato, il contenuto in input viene automaticamente controllato per individuare eventuali contenuti potenzialmente dannosi prima della generazione.
15 maggio
- Introdotta l'API di Auto-rigging e 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 l'API Multi-immagine in 3D, che consente la generazione di modelli 3D a partire 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 anche ameshy-5.
Apr 17
- Aggiunto il parametro
texture_image_urlalle API Immagine in 3D e Testo in 3D Refine, che consente 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 abilitare l'accesso ai nostri futuri modelli di AI avanzati per una migliore qualità di generazione.
Mar 14
- Le API Testo in texture ora supportano modelli codificati in base64 nel parametro
model_urltramite un Data URI, in modo simile alimage_urlnelle 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
- Testo in 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 attività di esempio.
Feb 13
-
Modifiche sostanziali:
- La creazione di attività con il piano gratuito terminerà il
20 marzo 2025. Dopo tale data, tutte le richieste di attività 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 attività con il piano gratuito terminerà il
-
Aggiunti endpoint di streaming Server-Sent Events (SSE) per aggiornamenti delle attività in tempo reale:
Feb 6
- Aggiunto il parametro
texture_promptalle API Immagine in 3D e Testo in 3D Refine, che permette agli utenti di guidare il processo di generazione delle texture con un prompt testuale.
January 2025
Jan 23
- Aggiunti endpoint per l'elenco dei task 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.
December 2024
Dec 19
- Aggiunte le Remesh APIs, che permettono agli utenti di eseguire il remesh ed esportare modelli 3D esistenti generati da altre API di Meshy in vari formati.
- Aggiornati i limiti del 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 Meshy-3 legacy dall'ultima API 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 credit.
- 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 rimangono supportati, ma consigliamo di passare ai nuovi percorsi.
Novembre 2024
Nov 14
- La Image to 3D API ora supporta immagini codificate in base64.