· reAPI Team
Statut de l’API fal : COMPLETED, mais aucun résultat
Comprends le statut de l’API fal quand COMPLETED ne donne aucun résultat. Vérifie les réponses de résultat, erreurs, champs de sortie et webhooks avant de relancer une génération.

COMPLETED est un mauvais endroit pour arrêter de lire. Dans l’API de file d’attente de fal, cela signifie que la requête est terminée, y compris si elle a échoué ou a été annulée. Cela ne signifie pas qu’une image ou une vidéo utilisable a été produite.[1]
L’appel suivant doit viser le point de terminaison de résultat de la requête d’origine. Cette réponse contient le statut HTTP et le corps renvoyés par le modèle.[2] Si ton application affiche un indicateur de progression vert mais ne trouve aucun fichier, examine ce résultat avant de soumettre une autre génération. Il te manque peut-être une étape de récupération, tu lis peut-être le mauvais objet JSON, ou tu rencontres une véritable erreur du modèle.
Le statut indique quand récupérer le résultat
Le statut de la file fal passe par IN_QUEUE, IN_PROGRESS et COMPLETED. Dès qu’il atteint COMPLETED, lis le résultat. Les champs comme metrics.inference_time et toutes les informations d’erreur disponibles fournissent un contexte utile, mais ne remplacent pas la réponse du modèle.[1]
Cette séparation apparaît dans les propres exemples d’API de fal : soumettre la requête, récupérer son statut, puis son résultat et consulter l’Output Schema du modèle. Les méthodes fal.queue.status() et fal.queue.result() du client JavaScript effectuent des opérations différentes. En Python, le statut terminé est suivi de handler.get().[3][4]
Regarde la variable que ton application transmet au composant d’image. Si elle contient le statut de la file, tu n’as pas encore atteint l’objet dont le composant a besoin. Récupère d’abord le résultat. Si elle contient l’objet enveloppant le résultat du SDK JavaScript, lis sa propriété data avant d’appliquer le schéma de sortie du modèle.[3] Remplacer images par image à tâtons est moins utile que vérifier quelle réponse tu as réellement.
La méthode d’appel compte ici. subscribe() soumet la requête et attend dans la file pour toi, tandis que submit() rend la main pour que ton application gère le cycle de vie. L’appel direct run() n’utilise pas la file.[4] Un exemple écrit pour une méthode peut donc contenir une étape d’attente ou d’extraction que ton code doit encore effectuer, ou qu’il a déjà effectuée.
Utilise les URL renvoyées par la soumission d’origine
Enregistre request_id, status_url et response_url lorsque la soumission réussit. Le guide de la file fal recommande d’utiliser les URL renvoyées. Si tu construis toi-même les URL de consultation, le guide distingue le chemin owner/app du chemin complet du point de terminaison du modèle utilisé pour soumettre le travail.[3] Ajouter chaque suffixe de modèle à une route de statut de requête peut envoyer la recherche au mauvais endroit.
Pour un worker susceptible de redémarrer, enregistre ces valeurs hors du processus avant d’attendre. Ton traitement local pourra alors continuer en lisant la même requête. C’est une recommandation de conception applicative : un bouton de nouvelle tentative ne devrait pas avoir à reconstruire la soumission d’origine simplement pour savoir si son résultat existe.
Le JavaScript suivant lit une requête enregistrée sur ton serveur. Les URL doivent provenir de la réponse de soumission fal fiable de ce serveur, et non d’une saisie arbitraire du navigateur : la requête joint tes identifiants d’API.
async function inspectFalRequest(saved, key) {
async function read(url) {
const response = await fetch(url, {
headers: { Authorization: `Key ${key}` },
redirect: "error",
});
const raw = await response.text();
let body;
try {
body = JSON.parse(raw);
} catch {
body = raw;
}
return { http: response.status, ok: response.ok, body };
}
const state = await read(saved.status_url);
const lifecycle = state.body?.status;
if (!state.ok || !["IN_QUEUE", "IN_PROGRESS", "COMPLETED"].includes(lifecycle)) {
return { stage: "status-read-error", ...state };
}
if (lifecycle !== "COMPLETED") {
return { stage: "pending", ...state };
}
const result = await read(saved.response_url);
return { stage: "result", ...result };
}Cette fonction utilitaire conserve volontairement une réponse non JSON sous forme de texte. Sinon, un échec d’analyse JSON pourrait remplacer l’erreur utile par une autre exception. Un échec de connexion lève toujours une exception vers l’appelant ; conserve la requête enregistrée pour que l’étape de récupération suivante puisse examiner le même traitement. La fonction n’effectue aucun POST de génération.
Son indicateur ok est le résultat HTTP de la lecture, pas une affirmation que ton produit dispose d’un média utilisable. Tu dois encore examiner le corps. De même, status-read-error signifie que cette consultation n’a pas établi l’état de la file. Cela ne signifie pas que la génération distante a échoué.
En Python, examine la gestion des exceptions autour de handler.get() ainsi que l’appel lui-même. Un gestionnaire général qui renvoie None pour chaque exception laisse la partie suivante de ton application avec une valeur vide et aucune explication. Conserve les informations d’exception pour le diagnostic et prévois un chemin d’erreur distinct dans l’application. Ne laisse pas la même valeur vide représenter une requête encore en attente, une entrée rejetée et un fichier généré avec succès mais pas encore téléchargé.
Pendant le débogage JavaScript, un relevé des noms de champs de la réponse, débarrassé des données sensibles, peut révéler un mauvais chemin d’objet. N’inclus pas d’identifiants ni de contenu d’entrée privé dans les journaux partagés. Une fois le chemin établi, valide les champs requis avant de transmettre le résultat à ton composant d’image ou de vidéo.
Si le problème vient de l’authentification, vérifie le compte qui a créé la tâche. Les clés fal sont créées dans la zone Keys du tableau de bord et appartiennent au compte sélectionné. Garde les identifiants sur ton serveur, généralement dans FAL_KEY ; les requêtes brutes utilisent Authorization: Key ....[5] Créer une clé sous un autre compte ne transfère pas une requête existante vers ce compte. Ne place pas une clé fonctionnelle dans le code du navigateur pour faciliter le débogage.
Lis l’erreur là où elle s’est produite
Une réponse de résultat peut expliquer pourquoi une requête terminée n’a pas de média. fal documente les statuts de résultat suivants :[2]
| Réponse de résultat | Éléments à examiner |
|---|---|
400, requête toujours en cours | Reviens à l’URL de statut enregistrée et continue d’observer cette requête |
401 | Les identifiants, l’en-tête et le compte utilisés pour la consultation |
404 | L’ID de requête, l’URL de consultation, le compte et les règles de conservation applicables |
422 | L’erreur de validation ou de modèle renvoyée |
499 | L’annulation enregistrée |
500 ou une autre erreur serveur | Le corps réel de la réponse et l’ID de requête |
N’assimile pas la dernière ligne à un délai de connexion dépassé. Recevoir une erreur du modèle depuis le point de terminaison de résultat te donne une réponse à examiner. Ne pas réussir à joindre ce point de terminaison te laisse sans cette réponse. Les décisions de récupération diffèrent.
Par exemple, no_media_generated est une erreur de modèle 422 documentée : la génération s’est terminée sans produire le média attendu. fal l’indique comme non réessayable.[6] C’est un diagnostic précis lorsque l’erreur renvoyée le dit. Un composant d’image vide ne suffit pas à poser toi-même ce diagnostic.
Conserve intacte la structure de l’erreur. Les erreurs de requête peuvent comporter une chaîne detail et un error_type ; les erreurs de validation du modèle peuvent contenir un tableau detail avec des entrées typées. fal précise aussi que certains points de terminaison n’ont pas adopté le format d’erreur de modèle plus récent.[6][7] Un analyseur qui attend une structure unique pour chaque erreur peut masquer le message dont tu as le plus besoin.
Lorsque le résultat signale une erreur de fichier d’entrée, examine aussi le fichier source. Une URL qui fonctionne dans ton navigateur connecté peut ne pas être récupérable publiquement par le service. Le guide des fichiers de fal exige des URL d’entrée accessibles et précise que les hébergeurs peuvent bloquer les requêtes ou limiter leur débit.[8] Vérifie cette condition avant de modifier l’analyseur de sortie ; un échec de récupération de l’entrée et une erreur de champ de sortie surviennent à des étapes différentes.
« Échec de l’appel API » dans une application est donc un point de départ pour l’enquête, pas l’explication. Note quel appel a échoué et conserve son statut et son corps. Si tu cherches à savoir si cet échec aurait dû coûter des crédits, consulte le guide de facturation des requêtes échouées après avoir identifié l’issue réelle de la requête.
Une réponse JSON réussie exige encore une vérification du média
Ouvre l’Output Schema du point de terminaison exact auquel tu as soumis la requête. Certains modèles d’image renvoient un tableau images, tandis que d’autres modèles utilisent d’autres structures. Certains exposent sync_mode, qui peut renvoyer le média sous forme de data URI et omettre la sortie de l’historique des requêtes.[8] Ce sont des particularités propres aux modèles. Un gestionnaire générique qui suppose que chaque résultat contient un video.url téléchargeable ne les couvre pas.
Supposons plutôt que la réponse du modèle contienne l’URL de sortie attendue, mais que ton envoi vers le stockage ait échoué. C’est un cas hypothétique de récupération. Conserve l’URL et l’ID de requête d’origine, réessaie l’étape de transfert tant que le fichier reste disponible et vérifie que les octets enregistrés sont lisibles. Relancer la génération produirait une nouvelle opération sans expliquer ce qui est arrivé au fichier d’origine.
C’est aussi là qu’une migration d’API exige une correspondance explicite des champs. Les tâches média ordinaires de reAPI renvoient leur statut métier et leurs tableaux de médias dans une même réponse de tâche, avec output.image_urls ou output.video_urls. La référence des tâches et la référence des erreurs distinguent un résultat média absent d’un échec d’enregistrement du fichier généré.[9][10] Même là, un HTTP 200 ne suffit pas : lis le statut de la tâche et valide ce dont ton application a besoin. Changer de fournisseur ne supprime pas l’étape de traitement du fichier.
Les webhooks ajoutent un autre objet à bien distinguer
Les statuts des webhooks fal utilisent OK et ERROR, plutôt que les valeurs du cycle de vie de la file. Une notification OK peut contenir payload: null et payload_error lorsque le résultat ne peut pas être représenté en JSON. La documentation te renvoie vers le résultat de la file pour la récupération.[11]
Si ton workflow est piloté par des webhooks, examine toute la notification avant de conclure qu’il n’y a pas de résultat. Un analyseur écrit pour le champ status de la file ne devrait pas être réutilisé tel quel pour le statut et la charge utile du webhook. Associe la notification à la requête existante, puis récupère le résultat si ses champs l’exigent.
Pour les traitements longs, fal recommande le statut de la file et les webhooks au lieu de maintenir indéfiniment un appel bloquant ouvert.[3] Conserve un chemin de consultation dans ton propre workflow même lorsque les rappels constituent le chemin normal. Une notification manquée devrait te laisser un ID à examiner, et non imposer une nouvelle génération pour relancer le workflow.
Enregistre rapidement les résultats terminés. La disponibilité des résultats de la file, le stockage des charges utiles de l’historique des requêtes et la conservation des fichiers média sont des sujets distincts ; la taille du résultat et les paramètres de stockage peuvent les affecter différemment.[2][11][12] Si tu as besoin du fichier plus tard, copie-le dans un stockage que tu contrôles et note si la copie a réussi. Une URL enregistrée seule n’est pas une archive.
Quand rechercher une panne
Si le résultat d’origine ne peut pas être récupéré, compare l’heure de l’échec et le service touché avec la page de statut officielle et l’historique des incidents de fal. Cette page distingue les composants : regarde donc la partie pertinente pour ta requête au lieu de considérer n’importe quel avis comme une explication de chaque erreur.[13] Cet article ne fournit pas d’évaluation de disponibilité en direct.
Un statut terminé sans fichier affiché ne suffit pas à établir que fal est en panne. L’absence d’avis de statut ne prouve pas non plus que ton code est erroné. Les prochains éléments utiles restent ceux de la réponse de résultat d’origine : son code HTTP, son corps, son point de terminaison et son ID de requête. Une fois en possession de ces éléments, tu peux décider de réparer la récupération, corriger une entrée, récupérer un fichier ou faire remonter une erreur de service non résolue.
Références
- fal. Obtenir le statut d’une requête. Référence de l’API de file d’attente. Consulté le 15 novembre 2026.
- fal. Obtenir le résultat d’une requête. Référence de l’API de file d’attente. Consulté le 15 novembre 2026.
- fal. File d’attente. Guide d’inférence des API de modèles. Consulté le 15 novembre 2026.
- fal. Méthodes d’inférence : comment appeler les modèles fal. Consulté le 15 novembre 2026.
- fal. Obtenir ta clé API. Consulté le 15 novembre 2026.
- fal. Erreurs de modèle. Comprend l’entrée
no_media_generated. Consulté le 15 novembre 2026. - fal. Erreurs de requête. Guide des API de modèles. Consulté le 15 novembre 2026.
- fal. FLUX.1 [dev] API. Sections Files et Schema. Consulté le 15 novembre 2026.
- reAPI. Tâches. reapi.ai/docs/api/tasks. Consulté le 15 novembre 2026.
- reAPI. Erreurs. reapi.ai/docs/api/errors. Consulté le 15 novembre 2026.
- fal. Webhooks. Guide d’inférence des API de modèles. Consulté le 15 novembre 2026.
- fal. Conservation des données. Guide des API de modèles. Consulté le 15 novembre 2026.
- fal. Statut de fal. Interface de la page de statut officielle vérifiée le 15 novembre 2026 ; aucune évaluation de disponibilité n’est affirmée ici.