Quando generi asset 3D tramite l'API di Meshy, il risultato di ogni task viene archiviato temporaneamente sui server di Meshy. Comprendere la finestra di conservazione ti aiuta a pianificare la tua integrazione e ti assicura di scaricare gli output prima della loro scadenza.
Conservazione degli asset per tipo di task
I periodi di conservazione variano in base al tipo di task:
Tipo di task | Periodo di conservazione |
Text to 3D | 3 giorni dopo il completamento del task |
Image to 3D | 3 giorni dopo il completamento del task |
Rigging | 2 mesi dopo il completamento del task |
Text to 3D e Image to 3D
I task e i loro output — file dei modelli, immagini di anteprima e texture — vengono conservati per 3 giorni dal momento del completamento del task. Dopo questa finestra, il task e tutti gli URL di download associati non saranno più accessibili.
Ogni risposta di un task API include un campo expires_at (timestamp Unix in millisecondi) che indica esattamente quando il task verrà eliminato:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Monitora questo valore nella tua integrazione e avvia i download prima che scada.
Task di Rigging
I task di rigging vengono conservati per 2 mesi dopo il completamento. Questa finestra estesa ti consente di continuare ad aggiungere nuove animazioni allo stesso personaggio rigged utilizzando l'ID del task di rig originale — senza dover eseguire nuovamente il rig della mesh.
Per animare un rig esistente, fai riferimento all'ID del task di rig nella tua richiesta di animazione in qualsiasi momento entro la finestra di conservazione di 2 mesi.
Recupero dei tuoi asset
Per accedere agli asset generati tramite API prima che scadano:
Scarica immediatamente. Non appena un task raggiunge lo stato
SUCCEEDED, scarica i file di output (GLB, FBX, OBJ, ecc.) nel tuo spazio di archiviazione.Usa l'endpoint di elenco dei task. Recupera gli ID dei task recenti e gli URL di output tramite gli endpoint API di elenco di Text to 3D o Image to 3D.
FAQ
1. Perché il mio modello generato tramite API non compare nel mio workspace?
Si tratta di un comportamento previsto. Gli asset generati tramite API non compaiono nell'interfaccia del Workspace di Meshy. È una scelta progettuale — l'API e il Workspace hanno cicli di vita degli asset separati con regole di scadenza diverse.
2. Perché l'URL del mio task restituisce un errore 404?
Se il timestamp expires_at del task è trascorso, l'asset è stato eliminato dai server di Meshy. Dovrai inviare nuovamente il task di generazione. Per evitare questo problema in futuro, configura download automatici nel tuo spazio di archiviazione non appena i task vengono completati con successo.
3. Posso aggiungere nuove animazioni a un personaggio dopo la scadenza del task di rig?
I task di rigging sono disponibili per 2 mesi, offrendoti un ampio intervallo di tempo per continuare ad aggiungere animazioni. Se il task di rig è scaduto (oltre 2 mesi), dovrai eseguire nuovamente il rig della mesh originale.
Nota: Meshy non garantisce la compatibilità dello scheletro tra esecuzioni di rigging separate.