Consulter une vidéo
Consultez la progression et le résultat d’un objet vidéo Wan 3.0 au format plateforme.
Utilisez l’ID public renvoyé à la création. La réponse est un objet video unique.
/v1/videos/{task_id}Authentification
bearerAuth Utilisez l’API Key de la plateforme : Authorization: Bearer your-api-key.
Emplacement: header
Paramètres de chemin
ID public de tâche renvoyé par la plateforme. Conservez-le comme chaîne pour les consultations et téléchargements, et non request_id ou un ID de tâche amont imbriqué.
1 <= lengthCorps de réponse
application/json
application/json
application/json
Lire l’état et l’URL vidéo
status | Signification et action |
|---|---|
queued | En attente ; réessayer la consultation plus tard |
in_progress | En cours ; consulter à nouveau plus tard |
completed | Génération terminée ; lire metadata.url |
failed | Échec ; lire error si disponible et arrêter le polling |
unknown | État non reconnu ; ne pas considérer comme réussi |
Conservez id ; la consultation ne dépend pas du champ redondant task_id de création. Ne déduisez pas la réussite de progress, completed_at ou de la présence de error. completed_at provient de la mise à jour du registre ; utilisez status.
Après réussite, enregistrez l’URL ou utilisez l’API de téléchargement vidéo. Cette API ne renvoie pas output/usage natifs ; consultez la consultation native pour l’utilisation.
Polling et gestion des erreurs
Consultez environ toutes les 15 secondes avec un délai global. Les requêtes lisent les tâches enregistrées ; des appels rapprochés peuvent renvoyer le même état. Arrêter le polling n’annule pas la génération.
Pour HTTP 400 et task_not_exist, vérifiez le site de l’ID de tâche et utilisez une API Key du compte propriétaire. Pour HTTP 401, corrigez l’authentification avant de continuer. La réussite est déterminée par status.