Lorsque vous générez des assets 3D via l'API Meshy, chaque tâche et ses résultats sont stockés sur les serveurs de Meshy pendant une durée limitée. Cette durée dépend de votre plan de compte, et non du type de tâche. Téléchargez vos résultats avant leur expiration.
Conservation des assets par plan
Plan | Durée de conservation |
Pro, Premium, Ultra | 3 jours |
Studio | 14 jours |
Enterprise | Conservés en permanence |
La durée de conservation s'applique à tous les types de tâches API, y compris leurs résultats : fichiers de modèle, images de prévisualisation et textures. Une fois cette durée écoulée, la tâche et toutes ses URLs de téléchargement sont supprimées et ne peuvent pas être récupérées.
Vous pouvez comparer les plans sur notre page de tarifs.
Vérifier l'expiration d'une tâche
Chaque réponse d'une tâche API inclut un champ expires_at (horodatage Unix en millisecondes) indiquant précisément quand la tâche sera supprimée :
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}Surveillez cette valeur dans votre intégration et téléchargez les résultats avant son dépassement.
Récupérer vos assets
Téléchargez immédiatement. Dès qu'une tâche atteint le statut
SUCCEEDED, téléchargez les fichiers de sortie (GLB, FBX, OBJ, etc.) vers votre propre stockage.Utilisez l'endpoint de liste des tâches. Récupérez les IDs des tâches récentes et les URLs de sortie avec l'endpoint de liste correspondant à chaque type de tâche.
FAQ
1. Pourquoi ne puis-je pas trouver les assets que j'ai générés ?
Si vous ne les avez pas téléchargés à temps, les assets ont été supprimés à la fin de leur période de conservation. Les assets supprimés ne peuvent pas être récupérés — vous devrez soumettre à nouveau la tâche.
2. Si j'appelle DELETE sur une tâche, mes images et modèles uploadés sont-ils également supprimés ?
La suppression d'une tâche supprime définitivement la tâche, y compris ses modèles et ses données. Une suppression est irréversible, alors téléchargez d'abord tout ce dont vous avez besoin.
3. Pourquoi mon modèle généré par l'API n'apparaît-il pas dans mon espace de travail ?
C'est le comportement attendu. Les assets générés par l'API n'apparaissent pas dans le Meshy Workspace — l'API et le Workspace ont des cycles de vie d'assets distincts.
4. Pourquoi mes URLs de tâches retournent-elles 404 ?
L'heure expires_at de la tâche est dépassée, l'asset a donc été supprimé. Soumettez à nouveau la tâche et configurez des téléchargements automatiques vers votre propre stockage dès que les tâches réussissent.