Worlds
Obtenir le statut du monde
Récupère le statut et le résultat d'une tâche de génération de monde World Labs Marble
Interrogez ce point de terminaison pour vérifier le statut d'une tâche de génération World Labs Marble. Si la réponse de création incluait poll_url, préférez appeler cette URL exacte.
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
ID de la tâche de génération de monde.
Réponse
Seuls id et status sont requis dans une réponse de statut réussie. Les alias de tâche, les ID d'opération, les ressources du monde, les légendes, le coût et la chaîne error sont renvoyés lorsqu'ils sont disponibles. Une tâche terminée ne garantit pas que chaque URL de ressource est présente.
ID de la tâche publique.
Alias de l'identifiant de la tâche asynchrone.
ID de l'opération World Labs.
Statut de la tâche : pending, processing, completed, failed ou timeout.
ID du monde World Labs une fois terminé.
URL du monde Marble généré une fois terminé.
Alias pour l'URL principale du monde/modèle généré.
URL du maillage de collision GLB lorsqu'il est disponible.
URL de l'image panoramique lorsqu'elle est disponible.
URL de l'image miniature lorsqu'elle est disponible.
Légende du monde généré.
Détails du coût de génération lorsqu'ils sont disponibles, incluant total_credits. Consultez vos relevés d'utilisation pour connaître le montant facturé.
Message d'erreur en cas d'échec de la tâche.
Requête
curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"{ "id": "string", "task_id": "string", "operation_id": "string", "status": "pending", "world_id": "string", "world_marble_url": "string", "model_url": "string", "glb_url": "string", "pano_url": "string", "thumbnail_url": "string", "caption": "string", "cost": {}, "error": "string", "error_details": { "projection_version": 0, "status": 400, "message": "string", "type": "string", "code": "string", "param": "string", "retryable": true, "upstream": { "source": "string", "code": "string", "message": "string", "param": "string" } }}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
ID de la tâche de génération de monde.
Réponse
application/json
application/json
application/json