3D
Obtenir le statut d'un modèle 3D
Récupère le statut et le résultat d'une tâche de génération 3D
GET /v1/3d/generations/{id} est un endpoint de compatibilité. Il reste pris en charge pour les intégrations existantes. Les nouvelles intégrations doivent interroger GET /v1/tasks/{id} ; voir Obtenir le statut d'une tâche.
Appelez GET /v1/tasks/{id} pour vérifier le statut de votre tâche de génération de modèle 3D.
id et task_id identifient la même tâche.
Une tâche publique expirée ou indisponible peut renvoyer 404 async_task_not_found. Si la propriété de la tâche ne peut pas être établie pour la clé API actuelle, la réponse est 403 task_not_owned.
Paramètres de chemin
L'ID de la tâche de génération 3D.
Réponse
Les champs décrivant les résultats, les erreurs, les horodatages et le modèle sont renvoyés lorsqu'ils sont disponibles pour la tâche.
ID de la tâche.
Alias de l'identifiant de tâche asynchrone lorsqu'il est fourni.
URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.
Statut de la tâche : pending, processing, completed, failed ou timeout. Une tâche ayant échoué renvoie toujours un code HTTP 200.
Valeur de progression optionnelle. Renvoyée uniquement lorsqu'une valeur de progression réelle est disponible ; utilisez status pour déterminer l'achèvement.
URL pour télécharger le fichier de modèle 3D (une fois terminé). Un lien de résultat média TokenLab qui reste valide pendant 30 jours.
URL pour télécharger le modèle au format GLB (lorsqu'il est disponible).
URL pour télécharger le modèle au format FBX (lorsqu'il est disponible).
Message d'erreur (en cas d'échec).
Détails de l'échec lorsque la tâche a échoué : status, message, type, code, retryable et param lorsqu'un champ de requête est en cause.
Statut de sauvegarde des liens de résultat : days et items[] avec url, kind, status et expires_at. Ce champ peut être absent ; les liens fonctionnent toujours. Voir Rétention des données.
Requête
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Réponse
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"glb_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"fbx_url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"kind": "3d",
"content_type": "model/gltf-binary",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
},
{
"url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"kind": "3d",
"content_type": "application/octet-stream",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de chemin
L'ID de tâche asynchrone renvoyé par id / task_id, ou intégré dans poll_url
Réponse
application/json
application/json
application/json
application/json
application/json
application/json
application/json