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
- Controlla regolarmente il changelog e questa pagina per gli aggiornamenti sulle deprecazioni.
- Imposta
ai_modelsu un modello specifico, comemeshy-7.1, se la tua integrazione necessita di un output coerente.latestpunta sempre al modello standard più recente, quindi il suo output cambia quando viene rilasciato un nuovo modello. - Testa la tua integrazione con la sostituzione ben prima della data di ritiro del tuo modello attuale.
- Aggiorna il tuo codice per utilizzare la sostituzione consigliata il prima possibile.
- 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 API | Stato attuale | Deprecato | Data di ritiro |
|---|---|---|---|
meshy-7.1 | Attivo | N/D | N/D |
meshy-7 | Deprecato | 18 settembre 2026 | 31 dicembre 2026 (geometria); N/D (texture) |
meshy-6 | Attivo | N/D | N/D |
meshy-6-lite | Attivo | N/D | N/D |
meshy-n1 | Attivo | N/D | N/D |
meshy-5 | Ritirato | 11 settembre 2026 | 10 ottobre 2026 |
meshy-4 | Ritirato | N/D | 20 marzo 2026 |
meshy-3 | Ritirato | 14 gennaio 2025 | luglio 2025 |
meshy-t2.5 | Attivo | N/D | N/D |
meshy-t2 | Attivo | N/D | N/D |
meshy-t1 | Deprecato | 13 luglio 2026 | 30 novembre 2026 |
model_type: "lowpoly" | Deprecato | 13 luglio 2026 | 30 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"eai_model: "meshy-t1", oppure conmodel_type: "lowpoly"eai_modelomesso,latest, omeshy-6. Meshy ignoratarget_polycount,topology,image_enhancement,remove_lighting, eexperimentalsu di esse. - Un'anteprima di Testo in 3D con
model_type: "lowpoly"eai_modelomesso,latest,meshy-6, omeshy-4(altrimenti ritirato,meshy-4è accettato qui solo per questo fallback). Meshy ignoratarget_polycount,topology, eexperimentalsu 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.
| Annunciato | Modello o funzionalità deprecati | Data di ritiro | Sostituzione consigliata |
|---|---|---|---|
| 02-10-2026 | model_type: "lowpoly" e meshy-t1 su Testo in 3D e Immagine in 3D | 30 novembre 2026 | model_type: "smart-topology" con ai_model: "meshy-t2.5" |
| 29-09-2026 | /v2/text-to-3d senza il prefisso /openapi | Da annunciare | /openapi/v2/text-to-3d |
| 18-09-2026 | meshy-7 come ai_model dell'anteprima di Testo in 3D, Immagine in 3D, e Multi-immagine in 3D | 31 dicembre 2026 | meshy-7.1 |
| 16-09-2026 | Chiave API condivisa in modalità test | 16 settembre 2026 | La tua chiave personale dalla pagina delle chiavi API, o il Playground |
| 11-09-2026 | meshy-5 | 10 ottobre 2026 | meshy-6-lite |
| 20-03-2026 | meshy-4 | 20 marzo 2026 | meshy-6 |
| 01-10-2025 | API Testo in Voxel | 1 ottobre 2025 | Nessuna |
| 01-07-2025 | API Testo in texture | 1 luglio 2025 | Retexture |
| 14-01-2025 | meshy-3 | luglio 2025 | meshy-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.
| Parametro | Stato | Comportamento | Sostituzione consigliata |
|---|---|---|---|
texture_image_url su Rigging | Deprecato il 23 ottobre 2026 | Funziona 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_mode | Deprecato il 18 settembre 2026 | ultra_mode: true equivale a geometry_resolution: "2k". | geometry_resolution |
hd_texture | Deprecato il 21 luglio 2026 | hd_texture: true equivale a texture_resolution: "4k". Se invii entrambi, Meshy utilizza texture_resolution. | texture_resolution |
| Parametri di conversione e ridimensionamento di Remesh | Deprecati il 22 maggio 2026 | Funzionano ancora. | Converti e Ridimensiona |
symmetry_mode | Deprecato l'11 maggio 2026 | Accettato e ignorato. | Ometti il parametro. |
art_style sull'anteprima di Testo in 3D | Deprecato il 22 gennaio 2026 | Accettato e ignorato. Si applicava solo a Meshy 4 e Meshy 5. | Ometti il parametro. |
is_a_t_pose | Deprecato il 4 dicembre 2025 | Funziona ancora. | pose_mode |