· reAPI Team
État d’une tâche Kie AI : bloquée à 99 % ou encore en cours ?
Lis l’état d’une tâche Kie AI quand une génération reste à 99 %. Vérifie tâche initiale, résultat, callback et crédits avant de décider d’en soumettre une autre.

La barre de progression a atteint 99 %. La vidéo n’est toujours pas là. Avant de cliquer à nouveau sur Générer, retrouve l’identifiant de tâche du premier essai : c’est ainsi que tu sauras si tu attends une vidéo ou si tu attends que ton application remarque une vidéo qui existe déjà.
L’état d’une tâche Kie AI provient de son enregistrement. Pour les jobs Market, cet enregistrement distingue attente, génération, réussite et échec, et contient le résultat ou l’erreur à côté de l’état.[1] Un pourcentage seul ne peut pas décider de la suite à ta place. Commence par la tâche existante, puis suis la branche que sa réponse justifie réellement.
Retrouve la tâche à l’origine de la barre de progression
Ouvre la réponse à ta soumission initiale. Si tu as utilisé l’API Market de Kie, cherche le taskId renvoyé. La consultation se fait avec GET /api/v1/jobs/recordInfo?taskId=... ; elle récupère les jobs créés avec POST /api/v1/jobs/createTask. Les autres familles de points d’accès nécessitent leur propre documentation. Une requête de chat synchrone, par exemple, ne produit pas de tâche Market à interroger.[2][1]
Si tu utilises le site, la zone Logs de Kie est l’endroit documenté pour retrouver les tâches soumises, leurs paramètres et leurs résultats.[3] Dans une automatisation, examine la sortie du nœud de soumission. Copie l’identifiant de là plutôt que depuis une tentative ultérieure : deux soumissions avec le même prompt restent deux essais à suivre.
Dans ta propre application, enregistre l’identifiant du fournisseur à côté de la référence du job client. Imagine une publication programmée appelée friday-demo, dont la vidéo est encore en attente. Le nom de la programmation indique à quoi sert la vidéo ; l’identifiant du fournisseur indique quelle génération récupérer. C’est une structure d’enregistrement suggérée, pas une fonctionnalité Kie. Garder les deux permet de redémarrer ton worker sans recommencer le travail créatif.
Aucun identifiant de tâche ? Retourne aux journaux de soumission avant de modifier le prompt. Une réponse perdue laisse la première soumission sans résolution. Tu dois établir si elle a été acceptée, via l’historique de compte disponible ou le support, avant de considérer une deuxième soumission comme une relance sans conséquence.
Lis la réponse avant de modifier le workflow
Deux vérifications précèdent l’examen de l’état de la tâche. Inspecte d’abord la réponse HTTP. Puis inspecte le code JSON. La référence des tâches de Kie documente des erreurs métier dans des réponses HTTP 200, notamment des identifiants d’accès invalides et des identifiants de tâche manquants, inexistants ou appartenant à un autre compte. Elle liste aussi des réponses d’erreur HTTP. Ne traiter qu’une de ces formes laisse une lacune.[1]
Cela compte lorsqu’un workflow semble bloqué. Si ton mécanisme d’interrogation reçoit sans cesse une erreur de consultation mais que l’écran affiche toujours sa dernière progression, regarder le pourcentage une minute de plus ne te dira pas ce que fait la tâche. Compare l’identifiant et le compte à la soumission initiale. Enregistre le corps de l’erreur sans la clé API. Répare la consultation avant de diagnostiquer la génération.
Une fois la consultation réussie, lis data.state :
waitingetqueuingsignifient que la tâche attend dans une file.generatingsignifie que le traitement est en cours.successsignifie que tu peux examiner le résultat renvoyé.failsignifie que tu dois examinerfailCodeetfailMsg.
Ce sont les états documentés de l’API Market.[1] Une valeur inconnue mérite son propre traitement dans ton client ; la traiter silencieusement comme un échec transformerait une réponse que tu ne comprends pas en raison de générer à nouveau.
Le décodeur suivant sépare ces cas. Il opère sur une réponse que ton serveur a déjà récupérée. Il ne contient ni soumission ni relance automatique.
function inspectMarketTask(httpStatus, body) {
if (httpStatus < 200 || httpStatus >= 300) {
return { kind: 'lookup_error', httpStatus };
}
if (body?.code !== 200 || !body.data) {
return { kind: 'lookup_error', code: body?.code, message: body?.msg };
}
const task = body.data;
if (['waiting', 'queuing', 'generating'].includes(task.state)) {
return { kind: 'pending', taskId: task.taskId, state: task.state };
}
if (task.state === 'fail') {
return {
kind: 'failed', taskId: task.taskId,
code: task.failCode, message: task.failMsg,
credits: task.creditsConsumed,
};
}
if (task.state !== 'success') {
return { kind: 'unknown_state', taskId: task.taskId, state: task.state };
}
let result;
try { result = JSON.parse(task.resultJson); }
catch { return { kind: 'result_unreadable', taskId: task.taskId }; }
const urls = result?.resultUrls;
if (!Array.isArray(urls) || !urls.length ||
urls.some(url => typeof url !== 'string' || !url.trim())) {
return { kind: 'output_missing', taskId: task.taskId };
}
return { kind: 'ready', taskId: task.taskId, urls };
}Les libellés kind appartiennent à cet exemple. La vérification de sortie couvre les jobs médias dont le resultJson analysé contient resultUrls ; elle ne couvre pas les sorties de tous les modèles. Les modèles de texte et de détection de sujets ont des structures différentes.[1] Même ready indique seulement que les chaînes d’URL attendues sont présentes. Il reste à télécharger et à vérifier le fichier lui-même.
Si la tâche a réussi, suis le fichier
Pour un job média réussi, analyse resultJson en JSON et cherche les URL attendues. Le champ est une chaîne JSON : lire task.resultJson.resultUrls comme s’il s’agissait déjà d’un objet ne récupérera pas le tableau décrit dans la documentation.[1]
Puis avance à partir de la réponse. Contient-elle le champ média attendu ? Ton serveur peut-il télécharger depuis cette URL ? L’étape de stockage a-t-elle enregistré les octets ? La page pointe-t-elle vers le fichier enregistré ? Chaque réponse précise où reprendre. L’échec d’un téléversement vers ton stockage justifie de recommencer ce téléversement tant que le fichier source reste disponible, pas d’acheter une autre génération.
Supposons, par exemple, que tes journaux montrent une tâche réussie suivie d’un échec de téléversement vers l’archive. Il s’agit d’un cas de débogage hypothétique. Garde l’identifiant de la tâche réussie rattaché au job, récupère son résultat si nécessaire et redémarre l’étape d’archivage. Si tu relances plutôt le workflow depuis son premier nœud, tu as renvoyé la même demande créative en génération sans résoudre l’échec de stockage.
Enregistre rapidement les sorties utiles. La page d’accueil de Kie indique une conservation des médias de 14 jours, mais la référence Market décrit une validité d’URL d’une heure pour OmniHuman 1.5 Subject Detection. Cette exception propre au modèle compte.[3][1] Un enregistrement de tâche réussie et un fichier téléchargeable indéfiniment sont deux choses différentes. Conserve ensemble le fichier téléchargé, l’identifiant d’origine et la réponse, afin qu’une URL manquante plus tard n’efface pas ta trace de ce qui s’est passé.
Si la génération continue, laisse la même tâche se terminer
Le guide de Kie recommande les callbacks en production et un espacement exponentiel pour les interrogations, en commençant à des intervalles de deux à trois secondes. Il indique aussi que certaines tâches vidéo prennent plus de dix minutes.[1] Cela suffit à rejeter une règle universelle « dix minutes signifient un échec ». Ce n’est pas la promesse que toute tâche retardée finira par réussir.
Ton application peut cesser d’attendre avant que la tâche cesse de tourner. Une publication programmée a une échéance ; une session de navigateur doit tenir compte de la patience de l’utilisateur. Décide de ce qui se passe lorsque ta propre limite d’attente expire. Un résultat local utile est « nécessite une intervention », en conservant l’identifiant de tâche pour une consultation ultérieure. L’appeler « échec » sans réponse terminale fait croire à l’opérateur suivant que la génération est terminée alors que tu as seulement arrêté de l’observer.
Si tu as configuré callBackUrl, vérifie aussi le chemin du callback. Kie prend en charge les notifications pour les tâches réussies et échouées. Son mécanisme de vérification signe l’identifiant de tâche et l’horodatage plutôt que le corps entier de la réponse, et son guide renvoie à une consultation authentifiée de la tâche pour obtenir le résultat faisant autorité.[4]
Utilise la notification pour réveiller le job existant. Récupère son état, puis exécute le même traitement de fin qu’après une interrogation. Si une interrogation a déjà récupéré la vidéo, un callback ultérieur doit retrouver ce job local terminé. Conçois ce gestionnaire pour qu’il ne puisse pas republier la même publication simplement parce que la fin est arrivée par un autre chemin.
Dans n8n, redémarre depuis l’étape qui nécessite du travail
Le réglage à examiner est Retry on Fail sur le nœud HTTP Request. La documentation n8n précise qu’il réessaie le nœud qui a échoué.[5] Lis l’opération à l’intérieur de ce nœud avant de l’activer.
Un nœud qui interroge une tâche connue peut répéter la consultation. Un nœud qui envoie le POST de génération répète une soumission. Ces opérations ne doivent pas partager la même décision de relance simplement parce qu’elles utilisent toutes deux HTTP. Si un workflow plus large regroupe soumission, attente et téléchargement en une étape redémarrable, isole l’identifiant de tâche enregistré pour que la reprise puisse commencer après la soumission.
Pour l’échec hypothétique d’archivage ci-dessus, le point de reprise est le nœud de téléchargement ou de stockage. Pour un callback perdu, c’est la consultation. Pour state: fail, lis d’abord l’échec et décide si une requête modifiée est justifiée. Pour une soumission au résultat inconnu, arrête la répétition automatique pendant que tu rapproches les données du premier essai.
Le guide du workflow vidéo quotidien montre une approche par jobs persistants sur reAPI. Ses champs API diffèrent de ceux de Kie, mais le choix de conception utile est le même : conserver assez d’état pour continuer le travail inachevé sans répéter le travail terminé.
Si la tâche a échoué, conserve l’erreur à côté du débit
Kie affirme que les tâches échouées ne sont pas facturées. La réponse de tâche expose aussi creditsConsumed, avec l’état, les champs d’erreur et les horodatages.[3][1] Compare ces enregistrements pour l’essai précis. Une variation de ton solde global ne peut pas identifier ce qui est arrivé à une vidéo si plusieurs autres jobs tournaient.
Si tu as déjà cliqué à nouveau sur Générer, conserve les deux identifiants dans l’enquête. La première tâche pourrait être celle représentée par la barre de progression, tandis que la deuxième serait celle dont tu regardes le débit. Associe chaque réponse à sa propre soumission avant de demander une correction de facturation.
Pour le support, mets d’abord l’identifiant de tâche et le modèle, puis l’heure de soumission et le fuseau horaire, la dernière réponse, le message d’erreur et l’écriture de crédits pertinente. Indique où le travail s’est arrêté : aucun état terminal, résultat réussi sans URL utilisable, téléchargement échoué ou incohérence apparente de facturation. La page d’accueil de Kie oriente les questions techniques vers ses groupes de support.[3] Retire les identifiants d’accès et les données privées sans rapport de tout ce que tu partages.
La politique des tâches échouées ne permet pas à cet article de promettre un remboursement pour un compte particulier. Elle te donne une anomalie précise à faire résoudre par le support. Si la tâche a réussi mais que la vidéo ne correspondait pas à ton brief, décris-le séparément ; une réclamation sur la qualité et un échec de génération enregistré sont des questions de support différentes.
Emporte la logique de reprise si tu changes d’API
Si des reprises récurrentes t’amènent à évaluer reAPI, commence par la réponse de tâche. Les jobs médias ordinaires utilisent processing, completed et failed ; les résultats se trouvent sous output, et usage.credits indique la consommation réglée. Interroger une tâche connue ne consomme pas de crédits.[6] Fais correspondre explicitement ces champs plutôt que de réutiliser sans modification un décodeur de réponse Kie.
Il y a des limites à prendre en compte. Les callbacks reAPI ne sont pas signés : vérifie donc une tâche en attente connue par consultation authentifiée ; les informations de livraison sont disponibles avec ?include=webhook.[7] Répéter un POST de génération avec Idempotency-Key ne le déduplique pas, et certains échecs de sécurité après génération, propres au modèle, restent facturés.[8][6] Conserve les vérifications des essais enregistrés et du règlement lors de la migration.
Utilise le catalogue des modèles pour vérifier le modèle dont tu as besoin et le comparatif Kie pour la question plus large du choix. Ni un changement de plateforme ni un second POST ne résout la vidéo déjà à 99 %. Pour celle-ci, reviens à son identifiant de tâche et reprends depuis la dernière étape dont tu peux établir le résultat.
Références
- Kie AI. Obtenir les détails d’une tâche, API Market. Consulté le 15 novembre 2026.
- Kie AI. Démarrage rapide Market et structure unifiée de l’API. Consulté le 15 novembre 2026.
- Kie AI. Questions fréquentes de la page d’accueil : tâches, support, conservation et crédits d’essai. Consulté le 15 novembre 2026.
- Kie AI. Vérification de sécurité des webhooks. Consulté le 15 novembre 2026.
- n8n. Problèmes courants du nœud HTTP Request : Retry on Fail. Consulté le 15 novembre 2026. Dépannage HTTP Request.
- reAPI. Tâches. Vérifié le 15 novembre 2026. Documentation d’interrogation des tâches.
- reAPI. Webhooks. Vérifié le 15 novembre 2026. Contrat de livraison et de vérification.
- reAPI. Vue d’ensemble de l’API. Vérifié le 15 novembre 2026. Documentation de soumission et d’idempotence.