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
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
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.
Identifiant canonique de la tâche asynchrone.
URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.
Horodatage Unix de création.
L'identifiant de la tâche.
Statut de la tâche : pending, processing, completed ou failed.
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 joursrevised_prompt(string) : Révision optionnelle du prompt, lorsque le modèle sélectionné en renvoie une
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.
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 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.
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 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