AGTCloud API Docs
GuidesRéférence APIIntégrations et ressourcesMises à jour et aide
Génération de vidéosKling

Consulter une vidéo

Consultez les tâches Kling 4.0 soumises au format plateforme.

Conservez l’identifiant reçu à la création et utilisez une API Key du même site. Arrêter l’interrogation n’annule pas la génération.

GET/v1/video/generations/{task_id}

Consultez la tâche de l’utilisateur avec l’ID reçu à la création plateforme. Arrêter les interrogations n’annule pas la génération.

Authentification

bearerAuth
AuthentificationBearer <token>

API Key plateforme : Authorization: Bearer your-api-key.

Emplacement: header

Paramètres de chemin

task_id*string

ID système reçu à la création. Les nouveaux ID sont des chaînes : ne pas convertir en nombres, afin de préserver la précision.

Longueur1 <= length

Corps de réponse

application/json

application/json

application/json

Lire le résultat

La consultation plateforme renvoie code/message/data, avec data comme objet tâche unique. code: "success" indique une consultation réussie ; vérifiez data.status pour savoir si la génération est terminée.

SituationSignification et action
HTTP 200, data.status: "processing"Traitement en cours ; data.url peut être vide. Réessayez plus tard
HTTP 200, data.status: "succeeded"Génération réussie ; lisez l’URL dans data.url et sauvegardez rapidement
HTTP 400, code: "task_not_exist"Tâche introuvable ; vérifiez identifiant, API Key et site
HTTP 401, Invalid tokenVérifiez Bearer et le site de l’API Key ; clé absente ou invalide peut produire la même erreur

data.error et data.metadata peuvent valoir null. Le format plateforme diffère de data[] natif. Consultez l’API native pour les champs et les tarifs catalogue.

HTTP 400/401 est une erreur de consultation, pas un échec de génération. La réponse peut ne pas contenir d’objet tâche normal. Corrigez l’erreur avant de lire l’URL ou de continuer les interrogations.