Consulter une vidéo
Consultez l’état natif, l’URL vidéo et l’utilisation Wan 3.0.
Utilisez output.task_id de création ; le champ output.task_id de la réponse reste l’ID public plateforme. Résultats et utilisation sont dans output et usage.
/api/v1/tasks/{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
États et résultats
output.task_status | Signification et action |
|---|---|
PENDING | En attente |
RUNNING | En cours |
SUCCEEDED | Réussi ; lire output.video_url |
FAILED | Échoué ; lire output.code/message et arrêter le polling |
CANCELED | Annulé ; arrêter le polling |
UNKNOWN | État inconnu ; ne pas considérer comme réussi |
Consultez environ toutes les 15 secondes avec un délai global. Les tâches enregistrées sont mises à jour en arrière-plan ; consultez-les au lieu de les recréer.
Téléchargez et enregistrez la vidéo rapidement après génération, avant expiration du lien.
Champs d’utilisation et de temps
usage.duration est la durée totale d’utilisation, entrée et sortie incluses si une vidéo est fournie. input_video_duration/output_video_duration peuvent être fractionnaires ; ne leur appliquez pas la règle des entiers du paramètre de requête. D’autres champs peuvent être renvoyés : video_count, fps, SR, ratio.
submit_time/scheduled_time/end_time sont des chaînes UTC+8 présentes si disponibles, pas des horodatages Unix. request_id trace une requête et ne sert pas aux consultations de tâches.
Erreurs de consultation
Pour HTTP 400 avec task_not_exist, vérifiez l’ID public, le site et le compte de l’API Key. Cela diffère de l’état UNKNOWN. Pour HTTP 401, vérifiez l’authentification Bearer.
Une erreur peut ne contenir que code/message/request_id à la racine, sans output. Pour le format video, voyez la consultation plateforme.