Consulter une vidéo
Consultez l’état et les résultats des tâches natives Kling 4.0 texte, image et Omni.
Utilisez data.id reçu à la création. En cas de succès, lisez l’URL dans outputs et sauvegardez rapidement. Seules les tâches accessibles à l’utilisateur sont retournées.
/kling/tasks/{task_id}Consultez une seule tâche Kling 4.0 de l’utilisateur : texte, image ou Omni. Utilisez l’ID système, pas options.external_task_id. États : submitted, processing, succeeded, failed. Arrêter les interrogations n’annule pas la tâche. billing expose prix catalogue et devise, pas les factures de compte ni les débits internes.
Authentification
bearerAuth API Key plateforme : Authorization: Bearer your-api-key.
Emplacement: header
Paramètres de chemin
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.
1 <= lengthCorps de réponse
application/json
application/json
application/json
billing.list_price est le prix catalogue dans la devise indiquée, pas le débit final de la plateforme. Il peut apparaître après la vidéo ; son absence ne signifie pas la gratuité.
États et sauvegarde
data est un tableau, même pour un seul ID. Le code de la requête diffère du status de génération ; vérifiez l’état avant d’utiliser les résultats.
status | Signification |
|---|---|
submitted | Soumis, en attente |
processing | Traitement en cours ; consulter plus tard |
succeeded | Génération réussie ; résultat dans outputs |
failed | Génération échouée ; lisez message et arrêtez les interrogations |
Le résultat vidéo a type égal à video ; id est l’ID vidéo, duration une durée en secondes sous forme de chaîne. url est une URL protégée contre les liens directs. Pour le filigrane, consultez watermark_url réellement retourné.
Les résultats amont sont supprimés après 30 jours : sauvegardez-les rapidement. Cette rétention ne garantit pas la validité des URL protégées pendant 30 jours.
Erreurs de consultation et échecs
| Situation | Vérification et action |
|---|---|
HTTP 400, task_not_exist | Utilisez l’ID système de création, vérifiez Key/site ; n’utilisez pas options.external_task_id |
HTTP 401, Invalid token | Vérifiez Bearer et la validité de la clé ; absence et invalidité peuvent donner la même erreur |
HTTP 200, tâche status: "failed" | Consultation réussie mais génération échouée ; lisez message et arrêtez les interrogations |
Les erreurs HTTP peuvent différer du succès data[]. Ne confondez pas HTTP 400/401 et état failed ; arrêtez les interrogations si l’authentification échoue ou si la tâche n’existe pas.