Consulter une tâche · Format historique

Ce chemin renvoie l’ancien objet dans code/message/data. Pour une nouvelle intégration, préférez la consultation plateforme ; les structures ne sont pas interchangeables.

GET/v1/video/generations/{task_id}

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez l’API Key de la plateforme : Authorization: Bearer your-api-key.

Emplacement: header

Paramètres de chemin

task_id*string

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é.

Longueur1 <= length

Corps de réponse

`application/json`

curl -X GET "https://api.agtcloud.cn/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "code": "success",
  "message": "",
  "data": {
    "created_at": 1792760030,
    "updated_at": 1792760030,
    "task_id": "task_example",
    "status": "NOT_START",
    "fail_reason": "",
    "submit_time": 1792760030,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {
      "request_id": "REQUEST_ID",
      "output": {
        "task_id": "upstream_task_example",
        "task_status": "PENDING"
      }
    }
  }
}

Lire le résultat historique

code: "success" indique seulement la réussite de la consultation ; vérifiez aussi data.status :

État	Signification
`NOT_START/SUBMITTED/QUEUED`	Non démarré, envoyé ou en attente
`IN_PROGRESS`	En cours
`SUCCESS`	Réussi ; lire `data.result_url`
`FAILURE`	Échoué ; lire `data.fail_reason` et arrêter le polling

data.progress est une chaîne comme "100%", et non une progression numérique. created_at/updated_at/submit_time/start_time/finish_time sont des horodatages Unix en secondes ; début et fin peuvent valoir 0 avant l’événement. Les exemples montrent les champs liés à la tâche ; d’autres peuvent être présents.

Consultez et téléchargez avec l’ID public de création, soit data.task_id ici. data.data contient la réponse native ; son ID ne sert pas aux consultations ou téléchargements plateforme.

Polling et gestion des erreurs

Consultez environ toutes les 15 secondes, définissez un délai global et arrêtez aux états terminaux. Enregistrez rapidement le résultat. Arrêter le polling n’annule pas la génération.

HTTP 400 task_not_exist et HTTP 401 sont des erreurs de requête, pas des états normaux. Vérifiez ID, site et API Key avant de traiter les données de tâche.

Documentation officielle Alibaba Cloud Wan 3.0 — génération vidéoRéférence du protocole natif ; les champs et réponses plateforme suivent cette page.

Consulter une tâche · Format historique

Authentification

Paramètres de chemin

Corps de réponse

200application/json

400application/json

401application/json

Lire le résultat historique

Polling et gestion des erreurs

`application/json`

`application/json`

`application/json`