TokenLab

Images

Obtenir le statut de l'image

Obtenir le statut et le résultat d'une tâche asynchrone de génération d'image

GET
/v1/tasks/{id}

Les chemins spécifiques aux images /v1/images/generations/{id} et /v1/images/{id} sont des points de terminaison de compatibilité. Ils restent pris en charge pour les intégrations existantes. Les nouvelles intégrations doivent interroger GET /v1/tasks/{id} ; voir Obtenir le statut de la tâche.

Paramètres de chemin

idstringpathrequis

L'ID de tâche renvoyé par la requête initiale de génération d'image.

Utilisez l' id ou le task_id provenant de la réponse de création.

L'alias de compatibilité /v1/images/{id} accepte les ID de tâches d'image publics tels que ldtask_.... Il utilise la même autorisation, les mêmes vérifications de propriété, les mêmes en-têtes de facturation, les mêmes instantanés terminaux et la même forme de réponse que /v1/images/generations/{id}.

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.

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

Identifiant canonique de la tâche asynchrone.

poll_urlstring

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

createdinteger

Horodatage Unix de création.

task_idstring

L'identifiant de la tâche.

statusstring

Statut de la tâche : pending, processing, completed ou failed.

dataarray

Tableau des images générées (rempli lorsque le status est completed).

Chaque objet contient :

  • url (string) : URL de résultat média TokenLab de l'image générée, valide pendant 30 jours
  • revised_prompt (string) : Révision optionnelle du prompt, lorsque le modèle sélectionné en renvoie une
errorstring | object

Raison de l'échec de la tâche (uniquement lorsque le status est failed) : une chaîne de caractères, ou un objet avec message et, lorsqu'ils sont connus, type, code, param et retryable.

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 d'image : days et items[] avec url, kind, status et expires_at. Il peut être absent ; les liens fonctionnent toujours. Voir Rétention des données.

usageobject

Nombre de jetons pour les modèles facturés par jetons tels que gpt-image-2, lorsqu'il est disponible.

Requête

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

Réponse

{
  "created": 1706000000,
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "data": []
}

Intervalle de vérification

Vérifiez toutes les 3 à 5 secondes tant que le statut est pending ou processing, et arrêtez-vous à completed ou failed.

import requests
import time

def poll_image_task(task_id, api_key, max_wait=300, interval=3):
    """Poll for image generation result with timeout."""
    url = f"https://api.tokenlab.sh/v1/tasks/{task_id}"
    headers = {"Authorization": f"Bearer {api_key}"}

    start_time = time.time()
    while time.time() - start_time < max_wait:
        response = requests.get(url, headers=headers, timeout=30)
        response.raise_for_status()
        data = response.json()

        if data["status"] == "completed":
            return data["data"][0]["url"]
        elif data["status"] == "failed":
            raise Exception(data.get("error", "Generation failed"))

        time.sleep(interval)

    raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")

# Usage
image_url = poll_image_task("ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sk-your-api-key")
print(f"Generated image: {image_url}")

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