TokenLab

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/tasks/{id}

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

idstringpathrequis

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.

idstring

ID de la tâche.

task_idstring

Alias de l'identifiant de tâche asynchrone lorsqu'il est fourni.

poll_urlstring

URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.

statusstring

Statut de la tâche : pending, processing, completed, failed ou timeout. Une tâche ayant échoué renvoie toujours un code HTTP 200.

progressinteger

Valeur de progression optionnelle. Renvoyée uniquement lorsqu'une valeur de progression réelle est disponible ; utilisez status pour déterminer l'achèvement.

model_urlstring

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.

glb_urlstring

URL pour télécharger le modèle au format GLB (lorsqu'il est disponible).

fbx_urlstring

URL pour télécharger le modèle au format FBX (lorsqu'il est disponible).

errorstring | object

Message d'erreur (en cas d'échec).

error_detailsobject

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.

media_retentionobject

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

Réponse (Terminée)
{
  "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
AuthorizationBearer <token>

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*string

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