Paramètres de chemin
string
requis
L’ID de tâche renvoyé par la requête de création de vidéo. Considérez
id et task_id comme la même identité asynchrone.Si une réponse de création renvoie
poll_url, appelez cette URL exacte. Lorsqu’elle pointe vers /v1/tasks/{id}, considérez-la comme le point de terminaison canonique et fixe pour le statut.Si la tâche n’existe plus ou n’est plus disponible dans l’enregistrement public de tâche, TokenLab renvoie async_task_not_found avec le message Task not found or no longer available.Réponse
string
Identifiant canonique de la tâche asynchrone.
string
Alias de l’identifiant de tâche asynchrone.
string
URL de polling préférée lorsque la réponse de création en fournit une.
string
ID de transaction de facturation TokenLab lorsque le règlement est déjà terminé. Il s’agit de l’identifiant utilisé pour le dashboard / le rapprochement, distinct de l’
id / task_id asynchrone.string
Statut de la tâche :
pending, processing, completed, failed.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 la vidéo générée (lorsqu’elle est terminée).
object
Charge utile d’une seule vidéo avec
url, duration, width et height lorsque disponible.array
Plusieurs charges utiles vidéo lorsque la tâche de génération renvoie plus d’une sortie.
string
Message d’erreur (en cas d’échec).
integer
Horodatage de création.
integer
Horodatage de la dernière mise à jour.
string
Modèle utilisé pour la tâche.
Bonnes pratiques de polling
- Effectuer un polling toutes les 5 à 10 secondes
- Implémenter un backoff exponentiel pour les tâches longues
- Définir un délai d’attente maximal (par exemple, 10 minutes)
- Gérer le statut
failedde manière appropriée