Obtenir le statut d'une tâche

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Vue d’ensemble

Utilisez cet endpoint pour un polling async unifié entre différents types de tâches tels que la génération de vidéo, d’image, de musique et de 3D. Si une réponse de création inclut poll_url, appelez ce chemin exact. Pour les workflows async plus récents, poll_url peut pointer vers /v1/tasks/{id}.

Paramètres de chemin

string

requis

L’ID de tâche renvoyé par la requête de création.

Réponse

string

Identifiant de la tâche.

string

Alias de l’identifiant de tâche asynchrone.

string

URL de polling à privilégier lorsque la réponse de création la fournit.

string

Statut de la tâche, par exemple pending, processing, completed ou failed. Les tâches annulées sont représentées comme failed avec cancelled: true.

boolean

true lorsqu’une tâche asynchrone en file d’attente a été annulée avant l’exécution.

string

Marqueur d’annulation. Présent avec la valeur cancelled lorsque l’annulation réussit.

array

Pour les tâches d’image terminées, les résultats générés sont renvoyés ici. Les tâches d’image renvoient des URL dans data[].url.

number

Valeur de progression facultative. Renvoyée uniquement lorsqu’une progression réelle est disponible ; utilisez status pour déterminer la fin de la tâche.

string

URL de l’asset de résultat lorsque la tâche est terminée et produit une vidéo.

string

Message d’erreur lorsque la tâche échoue.

Comportement d’erreur

Si la tâche n’existe plus, a expiré ou n’est plus disponible dans l’enregistrement public de tâche, TokenLab renvoie :

{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

Exemples

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Python

import requests

poll_url = "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
response = requests.get(
    f"https://api.tokenlab.sh{poll_url}",
    headers={"Authorization": "Bearer sk-your-api-key"},
)
print(response.json())

JavaScript

const pollUrl = '/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.tokenlab.sh${pollUrl}`, {
  headers: { Authorization: 'Bearer sk-your-api-key' },
});
console.log(await response.json());

Essentiel

Texte

Fichiers & lots

Images

Audio & temps réel

Musique

Vidéo & ressources

Worlds

3D

Tâches asynchrones

Gemini natif

Gestion

Obtenir le statut d'une tâche

Vue d’ensemble

Paramètres de chemin

Réponse

Comportement d’erreur

Exemples

​Vue d’ensemble

​Paramètres de chemin

​Réponse

​Comportement d’erreur

​Exemples

Vue d’ensemble

Paramètres de chemin

Réponse

Comportement d’erreur

Exemples