Lorsque vous générez des actifs 3D via l'API Meshy, chaque résultat de tâche est stocké temporairement sur les serveurs de Meshy. Comprendre la durée de conservation vous aide à planifier votre intégration et vous garantit de télécharger les résultats avant leur expiration.
Durée de conservation des actifs par type de tâche
Les durées de conservation varient selon le type de tâche :
Type de tâche | Durée de conservation |
Text to 3D | 3 jours après la fin de la tâche |
Image to 3D | 3 jours après la fin de la tâche |
Rigging | 2 mois après la fin de la tâche |
Text to 3D et Image to 3D
Les tâches et leurs résultats — fichiers de modèle, images d'aperçu et textures — sont conservés pendant 3 jours à partir de la fin de la tâche. Passé ce délai, la tâche et toutes les URL de téléchargement associées ne seront plus accessibles.
Chaque réponse de 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 déclenchez les téléchargements avant son expiration.
Tâches de Rigging
Les tâches de Rigging sont conservées pendant 2 mois après leur achèvement. Cette période prolongée vous permet de continuer à ajouter de nouvelles animations au même personnage riggé à l'aide de l'ID de la tâche de rig d'origine — sans avoir à re-rigger le mesh.
Pour animer un rig existant, référencez l'ID de la tâche de rig dans votre requête d'animation à tout moment pendant la période de conservation de 2 mois.
Récupération de vos actifs
Pour accéder aux actifs générés via l'API avant leur expiration :
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 ID de tâches récents et les URL de sortie via les endpoints de l'API de liste Text to 3D ou Image to 3D.
FAQ
1.Pourquoi mon modèle généré via l'API n'apparaît-il pas dans mon espace de travail ?
C'est un comportement attendu. Les actifs générés via l'API n'apparaissent pas dans l'interface du Workspace de Meshy. C'est intentionnel — l'API et le Workspace ont des cycles de vie d'actifs distincts avec des règles d'expiration différentes.
2.Pourquoi les URL de ma tâche renvoient-elles une erreur 404 ?
Si l'horodatage expires_at de la tâche est dépassé, l'actif a été supprimé des serveurs de Meshy. Vous devrez soumettre à nouveau la tâche de génération. Pour éviter cela à l'avenir, configurez des téléchargements automatiques vers votre propre stockage dès que les tâches aboutissent.
3.Puis-je ajouter de nouvelles animations à un personnage après l'expiration de la tâche de rig ?
Les tâches de Rigging sont disponibles pendant 2 mois, vous offrant une fenêtre généreuse pour continuer à ajouter des animations. Si la tâche de rig a expiré (plus de 2 mois), vous devrez re-rigger le mesh d'origine.
Remarque : Meshy ne garantit pas la compatibilité du squelette entre des exécutions de rigging distinctes.