Wanneer je 3D-assets genereert via de Meshy API, wordt het resultaat van elke taak tijdelijk opgeslagen op de servers van Meshy. Als je de bewaartermijn begrijpt, kun je je integratie beter plannen en zorg je ervoor dat je de outputs downloadt voordat ze verlopen.
Asset-retentie per taaktype
De bewaartermijnen verschillen per taaktype:
Taaktype | Bewaartermijn |
Tekst naar 3D | 3 dagen na voltooiing van de taak |
Afbeelding naar 3D | 3 dagen na voltooiing van de taak |
Rigging | 2 maanden na voltooiing van de taak |
Tekst naar 3D en Afbeelding naar 3D
Taken en hun outputs — modellbestanden, voorbeeldafbeeldingen en textures — worden 3 dagen bewaard vanaf het moment dat de taak is voltooid. Na deze termijn zijn de taak en alle bijbehorende download-URL's niet meer toegankelijk.
Elk API-taakantwoord bevat een expires_at-veld (Unix-timestamp in milliseconden) dat precies aangeeft wanneer de taak wordt verwijderd:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Houd deze waarde in de gaten in je integratie en start de downloads voordat deze verloopt.
Rigging-taken
Rigging-taken worden 2 maanden na voltooiing bewaard. Dit extendede venster stelt je in staat om nieuwe animaties toe te voegen aan hetzelfde gerigde personage met behulp van de originele rig-taak-ID — zonder dat je de mesh opnieuw hoeft te rigen.
Om een bestaande rig te animeren, verwijs je in je animatieverzoek op elk moment binnen de bewaartermijn van 2 maanden naar de rig-taak-ID.
Je assets ophalen
Om toegang te krijgen tot API-gegenereerde assets voordat ze verlopen:
Download onmiddellijk. Zodra een taak de status
SUCCEEDEDbereikt, download je de uitvoerbestanden (GLB, FBX, OBJ, enz.) naar je eigen opslag.Gebruik het list tasks-endpoint. Haal recente taak-ID's en output-URL's op via de Text to 3D- of Image to 3D-list-API-endpoints.
FAQ
1. Waarom verschijnt mijn API-gegenereerde model niet in mijn workspace?
Dit is verwacht gedrag. API-gegenereerde assets verschijnen niet in de Meshy Workspace UI. Dit is een bewuste ontwerpkeuze — de API en de Workspace hebben aparte asset-levenscycli met verschillende verloopregels.
2. Waarom geeft mijn taak-URL een 404 terug?
Als de expires_at-timestamp van de taak is verstreken, is de asset van de servers van Meshy verwijderd. Je moet de generatietaak opnieuw indienen. Stel om dit in de toekomst te voorkomen automatische downloads naar je eigen opslag in zodra taken slagen.
3. Kan ik nieuwe animaties toevoegen aan een personage nadat de rig-taak is verlopen?
Rigging-taken zijn 2 maanden beschikbaar, waardoor je ruim de tijd hebt om animaties toe te voegen. Als de rig-taak is verlopen (ouder dan 2 maanden), moet je de originele mesh opnieuw rigen.
Let op: Meshy garandeert geen skeletcompatibiliteit tussen afzonderlijke rigging-runs.