TokenLab

Vidéo & ressources

Obtenir le statut de la vidéo

Obtenir le statut et le résultat d'une tâche vidéo

GET
/v1/tasks/{id}

GET /v1/videos/generations/{id} est un endpoint de compatibilité. Il reste pris en charge pour les intégrations existantes et renvoie le résultat dans le même format que GET /v1/tasks/{id}. 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 la tâche renvoyé par la requête de création de vidéo. id et task_id identifient la même tâche.

Une lecture de statut renvoie HTTP 200 même lorsque la tâche a échoué ; vérifiez status. Une tâche expirée ou indisponible renvoie 404 async_task_not_found. Une tâche qui n'appartient pas à votre espace de travail renvoie 403 task_not_owned. 503 async_task_owner_unavailable est temporaire : réessayez la requête.

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

Même ID de tâche que id.

poll_urlstring

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

billing_transaction_idstring

ID de transaction de facturation après règlement. Il est distinct de l'ID de la tâche.

statusstring

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

progressinteger

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

video_urlstring

URL de la vidéo générée (une fois terminée). Il s'agit d'une URL de résultat média TokenLab qui reste valide pendant 30 jours ; voir Télécharger le résultat. Les tâches échouées et inachevées ne renvoient aucune URL de vidéo.

last_frame_urlstring

URL de la dernière image générée, lorsque vous l'avez demandée avec return_last_frame et que le modèle le prend en charge.

videoobject

Résultat vidéo unique avec url, duration, width et height lorsqu'ils sont disponibles.

videosarray

Résultats vidéo multiples lorsque la tâche renvoie plus d'une sortie.

errorstring | object

Raison de l'échec de la tâche (uniquement lorsque status est failed) : une chaîne de caractères, ou un objet avec message et, lorsqu'ils sont connus, type, code, param et retryable. Une tâche échouée peut également comporter error_details ; voir Tâches asynchrones et interrogation.

media_retentionobject

Statut de sauvegarde de la vidéo : days et items, chacun avec url, kind, status et expires_at. Il peut être absent lorsque le statut n'est pas connu à temps ; l'URL fonctionne toujours.

createdinteger

Horodatage de création.

updatedinteger

Horodatage de la dernière mise à jour.

modelstring

Modèle utilisé pour la tâche.

Requête

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

Réponse

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "veo3.1",
  "created": 1706000000,
  "updated": 1706000000
}

Télécharger le résultat

video_url ressemble à https://api.tokenlab.sh/v1/media-results/{id}.mp4?token=…. Le jeton dans l'URL est l'identifiant, donc aucun en-tête Authorization n'est nécessaire. Partagez l'URL uniquement avec les personnes autorisées à voir la vidéo. L'URL redirige vers le fichier, donc suivez les redirections lors du téléchargement (curl -L).

  • Elle reste valide pendant 30 jours à compter de l'enregistrement initial du résultat. Téléchargez le fichier si vous en avez besoin plus longtemps ; voir Rétention des données.
  • 404 media_not_found : le jeton ou l'extension de fichier ne correspond pas au résultat. Utilisez l'URL exacte que vous avez reçue.
  • 410 media_expired : la période de 30 jours est terminée.
  • 502 ou 503 media_unavailable : le résultat est en cours d'enregistrement, ou TokenLab est occupé. Réessayez après le délai Retry-After.
  • Ajoutez metadata=true à l'URL pour lire le statut de sauvegarde au lieu du fichier.

Certains résultats sont fournis sous la forme https://api.tokenlab.sh/v1/videos/generations/{id}/content. Cette URL nécessite le même en-tête Authorization: Bearer que celui utilisé pour l'interrogation, et seul l'espace de travail propriétaire de la tâche peut l'ouvrir.

Intervalle de vérification

  • Vérifiez toutes les 5 à 10 secondes.
  • Augmentez l'intervalle pour les tâches de longue durée.
  • Définissez un temps d'attente maximum pour votre application.
  • Arrêtez-vous lorsque le statut est failed et affichez l'erreur renvoyée.
import requests
import time

def wait_for_video(task_id, max_wait=600, interval=5):
    """Attendre la vidéo avec un délai d'expiration."""
    start = time.time()

    while time.time() - start < max_wait:
        response = requests.get(
            f"https://api.tokenlab.sh/v1/tasks/{task_id}",
            headers={"Authorization": "Bearer sk-your-api-key"}
        )
        response.raise_for_status()
        data = response.json()

        if data["status"] == "completed":
            return data["video_url"]
        elif data["status"] == "failed":
            raise Exception(data.get("error", "La génération de la vidéo a échoué"))

        time.sleep(interval)

    raise TimeoutError("La génération de la vidéo a expiré")

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