Deprecazioni
Scopri quali modelli AI di Meshy e funzionalità API sono attivi, deprecati o ritirati, e trova le date di ritiro e i sostituti consigliati.
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 dell'API, insieme al sostituto consigliato.
Overview
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 fattura.
- Deprecato: Funziona ancora, ma non è più consigliato. Meshy indica un sostituto consigliato e, una volta programmata, 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. I task creati con un modello ritirato rimangono disponibili per il consueto periodo di conservazione.
Migrating to Replacements
Una volta che un modello è deprecato, sposta tutte le tue richieste verso il suo sostituto prima della data di ritiro. Le richieste che utilizzano il modello dopo tale data falliscono.
Un sostituto può produrre risultati diversi rispetto al modello che sostituisce. Testa la tua integrazione con il sostituto con largo anticipo rispetto alla data di ritiro, ad esempio nel Playground.
Notifications
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.
Best Practices
- 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 ha bisogno 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 il sostituto con largo anticipo rispetto alla data di ritiro del tuo modello attuale.
- Aggiorna il tuo codice per utilizzare il sostituto consigliato il prima possibile.
- Contatta support@meshy.ai se hai bisogno di aiuto con una migrazione.
Model Status
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 | Da annunciare |
meshy-6 | Attivo | N/D | N/D |
meshy-6-lite | 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 ottobre 2026 |
model_type: "lowpoly" | Deprecato | 13 luglio 2026 | 30 ottobre 2026 |
latest corrisponde a meshy-7.1.
Deprecation History
Tutte le deprecazioni sono elencate di seguito, con gli annunci più recenti per primi.
| Annunciato | Modello o funzionalità deprecati | Data di ritiro | Sostituto consigliato |
|---|---|---|---|
| 2026-10-02 | model_type: "lowpoly" e meshy-t1 su Testo in 3D e Immagine in 3D | 30 ottobre 2026 | model_type: "smart-topology" con ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d senza il prefisso /openapi | Da annunciare | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 | Da annunciare | meshy-7.1 |
| 2026-09-16 | Chiave API condivisa per la modalità test | 16 settembre 2026 | La tua chiave personale dalla pagina delle API Keys, oppure il Playground |
| 2026-09-11 | meshy-5 | 10 ottobre 2026 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 20 marzo 2026 | meshy-6 |
| 2025-10-01 | API Testo in Voxel | 1 ottobre 2025 | Nessuno |
| 2025-07-01 | API Testo in texture | 1 luglio 2025 | Retexture |
| 2025-01-14 | meshy-3 | Luglio 2025 | meshy-6 |
API Parameter Deprecations
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 versione futura potrebbe rimuoverli.
| Parametro | Stato | Comportamento | Sostituto consigliato |
|---|---|---|---|
texture_image_url su Rigging | Deprecato il 23 ottobre 2026 | Funziona ancora. L'immagine diventa l'unica texture del modello riggato, e il modello perde le sue mappe PBR. | Omettilo. Meshy utilizza le texture di model_url o del task 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. | Omettilo. |
art_style su Text to 3D Preview | Deprecato il 22 gennaio 2026 | Accettato e ignorato. Si applicava solo a Meshy 4 e Meshy 5. | Omettilo. |
is_a_t_pose | Deprecato il 4 dicembre 2025 | Funziona ancora. | pose_mode |