lowpoly verrà ritirato il 30 ott 2026. meshy-7 come modello di generazione 3D verrà ritirato il 31 dic 2026; come modello di texture resta disponibile. Cambia modello prima di queste date per evitare errori nelle richieste. Vedi tutte le deprecazioni

Deprecazioni

Scopri quali modelli AI e funzionalità API di Meshy sono attivi, deprecati o ritirati, e trova le date di ritiro e le sostituzioni consigliate.

Man mano che Meshy rilascia nuovi modelli, ritira quelli più vecchi. Le integrazioni che si basano su un modello o una funzionalità API più vecchi potrebbero richiedere aggiornamenti occasionali per continuare a funzionare. Questa pagina elenca ogni deprecazione API, insieme alla sostituzione consigliata.


Panoramica

Meshy utilizza questi termini per descrivere il ciclo di vita di un modello o di una funzionalità API:

  • Attivo: Pienamente supportato e consigliato per l'uso.
  • Legacy: Non riceve più aggiornamenti e potrebbe essere deprecato in futuro. Funziona ancora, e nulla cambia riguardo alla tua richiesta o alla tua fatturazione.
  • Deprecato: Funziona ancora, ma non è più consigliato. Meshy indica una sostituzione consigliata e, una volta pianificata, una data di ritiro.
  • Ritirato: Non più disponibile. Le richieste che utilizzano un modello o una funzionalità ritirati restituiscono un errore.

Il ritiro di un modello non elimina ciò che hai già creato con esso. Le attività create con un modello ritirato restano disponibili per il consueto periodo di conservazione.


Migrazione alle sostituzioni

Una volta che un modello è deprecato, sposta tutte le tue richieste sulla sua sostituzione prima della data di ritiro. Le richieste che utilizzano il modello dopo tale data falliscono.

Una sostituzione può produrre risultati diversi rispetto al modello che sostituisce. Testa la tua integrazione con la sostituzione ben prima della data di ritiro, ad esempio nel Playground.


Notifiche

Meshy annuncia ogni deprecazione e ritiro nel changelog e in questa pagina. Mentre un ritiro è imminente, un banner nella parte superiore di ogni pagina API lo mostra, e le pagine degli endpoint contrassegnano il modello o il parametro come deprecato.

Meshy annuncia una data di ritiro almeno un mese prima del ritiro stesso.


Best Practice

  1. Controlla regolarmente il changelog e questa pagina per gli aggiornamenti sulle deprecazioni.
  2. Imposta ai_model su un modello specifico, come meshy-7.1, se la tua integrazione necessita di un output coerente. latest punta sempre al modello standard più recente, quindi il suo output cambia quando viene rilasciato un nuovo modello.
  3. Testa la tua integrazione con la sostituzione ben prima della data di ritiro del tuo modello attuale.
  4. Aggiorna il tuo codice per utilizzare la sostituzione consigliata il prima possibile.
  5. Contatta support@meshy.ai se hai bisogno di aiuto con una migrazione.

Stato dei modelli

Modelli di generazione 3D attuali e ritirati di Testo in 3D, Immagine in 3D, Multi-immagine in 3D, e Retexture. Non tutti gli endpoint offrono tutti i modelli; ogni pagina di endpoint elenca i modelli che accetta.

Nome modello APIStato attualeDeprecatoData di ritiro
meshy-7.1AttivoN/DN/D
meshy-7Deprecato18 settembre 202631 dicembre 2026 (geometria); N/D (texture)
meshy-6AttivoN/DN/D
meshy-6-liteAttivoN/DN/D
meshy-n1AttivoN/DN/D
meshy-5Ritirato11 settembre 202610 ottobre 2026
meshy-4RitiratoN/D20 marzo 2026
meshy-3Ritirato14 gennaio 2025luglio 2025
meshy-t2.5AttivoN/DN/D
meshy-t2AttivoN/DN/D
meshy-t1Deprecato13 luglio 202630 novembre 2026
model_type: "lowpoly"Deprecato13 luglio 202630 novembre 2026

latest si risolve in meshy-7.1.

Il ritiro di meshy-7 lo riguarda come ai_model delle attività di anteprima di Testo in 3D, Immagine in 3D, e Multi-immagine in 3D. meshy-7.1 accetta gli stessi parametri e costa lo stesso. Dal 31 dicembre 2026, tali richieste restituiranno 400.

meshy-7 come modello di texture non è interessato. Ciò riguarda Retexture, texture_model, e il ai_model di un refine di Testo in 3D, che seleziona solo il modello di texture.

Fino al 30 novembre 2026, queste richieste vengono comunque eseguite su un modello Smart Topology con topology a triangoli e hanno il costo del prezzo Smart Topology:

  • Immagine in 3D con model_type: "smart-topology" e ai_model: "meshy-t1", oppure con model_type: "lowpoly" e ai_model omesso, latest, o meshy-6. Meshy ignora target_polycount, topology, image_enhancement, remove_lighting, e experimental su di esse.
  • Un'anteprima di Testo in 3D con model_type: "lowpoly" e ai_model omesso, latest, meshy-6, o meshy-4 (altrimenti ritirato, meshy-4 è accettato qui solo per questo fallback). Meshy ignora target_polycount, topology, e experimental su di essa.

Ogni altra richiesta per meshy-t1 o lowpoly restituisce già 400. Dal 30 novembre 2026, anche queste restituiranno 400.


Cronologia delle deprecazioni

Tutte le deprecazioni sono elencate di seguito, con gli annunci più recenti per primi.

AnnunciatoModello o funzionalità deprecatiData di ritiroSostituzione consigliata
02-10-2026model_type: "lowpoly" e meshy-t1 su Testo in 3D e Immagine in 3D30 novembre 2026model_type: "smart-topology" con ai_model: "meshy-t2.5"
29-09-2026/v2/text-to-3d senza il prefisso /openapiDa annunciare/openapi/v2/text-to-3d
18-09-2026meshy-7 come ai_model dell'anteprima di Testo in 3D, Immagine in 3D, e Multi-immagine in 3D31 dicembre 2026meshy-7.1
16-09-2026Chiave API condivisa in modalità test16 settembre 2026La tua chiave personale dalla pagina delle chiavi API, o il Playground
11-09-2026meshy-510 ottobre 2026meshy-6-lite
20-03-2026meshy-420 marzo 2026meshy-6
01-10-2025API Testo in Voxel1 ottobre 2025Nessuna
01-07-2025API Testo in texture1 luglio 2025Retexture
14-01-2025meshy-3luglio 2025meshy-6

Deprecazioni dei parametri API

Meshy occasionalmente deprecata parametri di richiesta e campi di risposta che i modelli più recenti sostituiscono o non utilizzano più. Funzionano ancora salvo diversa indicazione, ma una release futura potrebbe rimuoverli.

ParametroStatoComportamentoSostituzione consigliata
texture_image_url su RiggingDeprecato il 23 ottobre 2026Funziona ancora. L'immagine diventa l'unica texture del modello con rig, e il modello perde le sue mappe PBR.Ometti il parametro. Meshy utilizza le texture di model_url o dell'attività di input.
ultra_modeDeprecato il 18 settembre 2026ultra_mode: true equivale a geometry_resolution: "2k".geometry_resolution
hd_textureDeprecato il 21 luglio 2026hd_texture: true equivale a texture_resolution: "4k". Se invii entrambi, Meshy utilizza texture_resolution.texture_resolution
Parametri di conversione e ridimensionamento di RemeshDeprecati il 22 maggio 2026Funzionano ancora.Converti e Ridimensiona
symmetry_modeDeprecato l'11 maggio 2026Accettato e ignorato.Ometti il parametro.
art_style sull'anteprima di Testo in 3DDeprecato il 22 gennaio 2026Accettato e ignorato. Si applicava solo a Meshy 4 e Meshy 5.Ometti il parametro.
is_a_t_poseDeprecato il 4 dicembre 2025Funziona ancora.pose_mode