När du genererar 3D-tillgångar via Meshy API lagras varje task-resultat tillfälligt på Meshys servrar. Att förstå lagringsfönstret hjälper dig att planera din integration och säkerställer att du laddar ner resultatet innan det upphör.
Lagring av tillgångar per task-typ
Lagringstiden varierar beroende på task-typ:
Task-typ | Lagringstid |
Text till 3D | 3 dagar efter att tasken slutförts |
Bild till 3D | 3 dagar efter att tasken slutförts |
Rigging | 2 månader efter att tasken slutförts |
Text till 3D och Bild till 3D
Tasks och deras resultat — modellfiler, förhandsbilder och texturer — sparas i 3 dagar från den tidpunkt då tasken slutförs. Efter detta fönster kommer tasken och alla tillhörande nedladdnings-URL:er inte längre att vara åtkomliga.
Varje API-task-svar innehåller ett expires_at-fält (Unix-tidsstämpel i millisekunder) som anger exakt när tasken kommer att raderas:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Övervaka detta värde i din integration och utlös nedladdningar innan det löper ut.
Rigging-tasks
Rigging-tasks sparas i 2 månader efter slutförande. Detta utökade fönster gör att du kan fortsätta lägga till nya animationer till samma riggad karaktär med hjälp av det ursprungliga rigg-task-ID:t — utan att behöva rigga meshen igen.
För att animera en befintlig rigg, referera till rigg-task-ID:t i din animationsbegäran när som helst inom det 2 månader långa lagringsfönstret.
Hämta dina tillgångar
För att komma åt API-genererade tillgångar innan de upphör:
Ladda ner omedelbart. Så snart en task har nått statusen
SUCCEEDED, ladda ner resultatfilerna (GLB, FBX, OBJ osv.) till din egen lagring.Använd list-task-endpointen. Hämta senaste task-ID:n och resultat-URL:er via list-API-endpointerna för Text till 3D eller Bild till 3D.
FAQ
1. Varför visas min API-genererade modell inte i min arbetsyta?
Detta är förväntat beteende. API-genererade tillgångar visas inte i Meshy Workspace-gränssnittet. Detta är avsiktligt — API:et och Workspace har separata tillgångslivscykler med olika utgångsregler.
2. Varför returnerar mina task-URL:er 404?
Om taskens expires_at-tidsstämpel har passerats har tillgången raderats från Meshys servrar. Du behöver skicka in genereringstasken igen. För att undvika detta i framtiden, konfigurera automatiska nedladdningar till din egen lagring så snart tasks slutförs.
3. Kan jag lägga till nya animationer till en karaktär efter att rigg-tasken har upphört?
Rigging-tasks är tillgängliga i 2 månader, vilket ger dig gott om tid att fortsätta lägga till animationer. Om rigg-tasken har upphört (äldre än 2 månader) behöver du rigga den ursprungliga meshen igen.
Obs: Meshy garanterar inte skelettkompatibilitet mellan separata rigg-körningar.