· reAPI Team
Erreur fal User is locked : vérifier compte, clé et solde
Diagnostique l’erreur fal User is locked en vérifiant la réponse, le compte, les crédits et les autorisations de la clé. Prépare des preuves pour le support avant de réessayer ou de payer davantage.

User is locked peut continuer à apparaître après un rechargement. Dans l’issue publique 922 de fal, des utilisateurs ont décrit ce décalage : le tableau de bord affichait des crédits, tandis que les requêtes recevaient toujours une réponse de verrouillage. Le fil contient différents correctifs et échecs rapportés ; son mainteneur a finalement orienté les personnes concernées vers le support propre à leur compte.[1]
Cet historique n’établit pas la cause de ton erreur. Il explique toutefois pourquoi « ajouter plus d’argent » ou « créer une autre clé » ne constitue pas une réponse complète. Commence par relever le motif complet renvoyé par l’API, le compte utilisé par l’application en cours d’exécution et l’heure de l’erreur. Mets en pause les soumissions automatiques de l’application tant que ces faits ne sont pas éclaircis.
Conserve le texte après « Reason »
Un message de solde épuisé et un message de verrouillage administratif ne doivent pas être regroupés dans une même entrée de journal. Conserve le corps complet de la réponse, avec son statut HTTP, son endpoint, sa méthode et son horodatage. Un journal qui ne garde que 403 a supprimé des informations dont tu auras besoin pour la prochaine décision.
Identifie ensuite l’opération qui a échoué. L’application soumettait-elle une nouvelle génération, vérifiait-elle une requête déjà acceptée ou tentait-elle d’en récupérer le résultat ? Une exception du SDK affichée à la fin d’un workflow peut provenir de n’importe laquelle de ces étapes. Le remède dépend de l’étape qui a effectivement reçu le refus.
Considère une séquence hypothétique : la soumission renvoie un identifiant de requête, le worker l’enregistre, puis une interrogation ultérieure reçoit l’erreur de verrouillage. Cette séquence ne prouve pas que la génération précédente a échoué ou a été annulée. Conserve l’identifiant et les réponses des deux opérations. Rejouer l’ensemble du workflow créerait une nouvelle soumission sans résoudre le sort de la requête existante.
À l’inverse, si la soumission initiale a été refusée et qu’aucun identifiant de requête n’est arrivé, consigne ce résultat précis. N’invente pas d’identifiant de tâche et n’attribue pas d’état final à la génération à partir du message d’autorisation. Tu cherches à savoir si l’opération était autorisée, tu n’évalues pas encore la qualité des médias générés.
Le guide des statuts terminés de fal traite le cas distinct où une requête connue atteint un état terminal, mais où son média manque. Distinguer ces cas évite qu’un problème de compte entraîne une régénération inutile.
Vérifie le compte avant d’interpréter le solde
La FAQ de fal indique que les comptes sont verrouillés lorsque leur solde passe sous le seuil de verrouillage du compte. Elle recommande d’ajouter des crédits dans ce cas et traite séparément la facturation sur facture des entreprises.[2] Cette règle ne signifie pas universellement que tout montant positif affiché garantit l’accès à chaque compte.
Associe d’abord le compte propriétaire de la clé de l’application au compte sélectionné dans le tableau de bord. Ajoute le contexte de l’équipe lorsque c’est pertinent. Le navigateur peut afficher une équipe approvisionnée alors qu’un worker utilise une clé personnelle ; c’est une possibilité à vérifier dans le cadre du dépannage, et non une explication que nous avons établie pour ta requête.
Inspecte la configuration du processus en cours à l’aide de tes outils habituels de gestion des secrets. Un nom de clé ou un identifiant sûr peut aider à confirmer la source sans afficher le secret. Si quelqu’un a récemment modifié l’identifiant, vérifie que le déploiement a réellement chargé la configuration prévue. Mettre à jour un fichier d’environnement local ne permet pas de savoir ce qu’utilise un worker distinct.
Compare l’observation du solde et l’erreur à des heures connues. Par exemple, une capture d’écran prise avant le rechargement ne peut pas montrer si le solde avait changé lorsque la requête ultérieure a échoué. Note ensemble l’heure du reçu, l’heure de la capture du tableau de bord et celle de l’opération échouée. Le support pourra ainsi examiner une séquence plutôt que deux captures d’écran sans date.
Si le solde du compte concerné et le motif renvoyé correspondent au seuil de financement documenté, suis ces consignes de facturation. Si un achat effectué n’apparaît pas, examine l’historique d’achat et de crédits. Si le bon compte affiche des crédits mais que le verrou reste inexpliqué, un autre dépôt ne prouve pas que le problème sera résolu.
Se connecter au tableau de bord est également une opération différente de l’accès à l’API. Si tu ne peux pas te connecter avec GitHub parce que le code à usage unique n’arrive jamais, la FAQ de fal conseille de vérifier l’adresse e-mail principale du compte GitHub.[2] Cela peut t’aider à accéder à la page du compte ; cela n’explique pas pourquoi une application déjà configurée reçoit une réponse de verrouillage du compte.
Un compte approvisionné peut tout de même avoir une mauvaise politique de clé
fal documente les préréglages d’autorisations, les listes d’autorisations personnalisées, les restrictions de modèles autorisés et l’expiration des clés. Son préréglage API est destiné à utiliser des modèles hébergés.[3] Ces contrôles déterminent ce que l’identifiant peut faire. Un solde indique les fonds disponibles. Corriger l’un ne confirme pas l’autre.
Compare l’opération exacte qui a échoué à la politique de la clé. Si la clé est limitée à certains modèles, vérifie que l’endpoint prévu respecte cette restriction. Si elle a expiré, corrige l’identifiant au lieu d’ajouter des crédits. Si un client envoie une clé différente de celle attendue, corrige cette configuration avant de modifier les autorisations du compte.
Un détail facile à manquer est la manière dont la politique a été créée. fal indique qu’une clé préréglée suit la définition actuelle du préréglage, tandis qu’une politique personnalisée conserve sa liste d’autorisations initiale. Ajouter une restriction de modèle enregistre la clé comme politique personnalisée.[3] Deux clés créées pour la même application peuvent donc mériter un examen distinct, plutôt que de supposer que leurs autorisations restent identiques.
Ne donne pas un accès complet à chaque clé simplement pour voir si l’erreur change. Accorde les opérations dont l’application a besoin et conserve l’ancienne politique dans tes notes d’enquête. Une requête réussie après plusieurs changements simultanés ne te permettrait pas de savoir lequel a compté — et pourrait laisser un accès plus large que nécessaire à l’application.
De même, remplacer une clé n’est pas une opération universelle de déverrouillage de compte documentée. Dans l’issue 922, certains utilisateurs ont signalé un succès après avoir créé une nouvelle clé ou mis à jour le SDK, tandis que d’autres ont dit que ces étapes n’avaient pas fonctionné.[1] Ce sont des observations individuelles. Elles n’établissent pas qu’une version du SDK, une migration de clé ou un déverrouillage différé soit la cause de tous les messages similaires.
Lorsque tu compares deux clients, commence par faire correspondre le compte prévu, le modèle et l’opération. Une requête réussie pour un modèle depuis un ordinateur portable ne prouve pas l’accès à un autre modèle depuis un worker planifié. Note la différence qui subsiste avant de choisir une correction. Sinon, un changement de modèle ou de compte peut être pris à tort pour une correction de la bibliothèque cliente.
Examine la version du client installée et la construction de la requête si les éléments pointent dans cette direction. Conserve la réponse complète du service avant de modifier les paquets. Cela permet de distinguer une correction de configuration du client d’une restriction de compte qui nécessite l’intervention du fournisseur.
Les modèles hébergés et les déploiements Serverless nécessitent des vérifications différentes
Si tu appelles uniquement les Model APIs hébergées de fal, le guide d’installation indique qu’il te faut une clé API et le SDK client, pas la Serverless CLI. Le déploiement de tes propres applications Serverless nécessite l’approbation du compte ; l’appel des Model APIs hébergées ne nécessite pas cette approbation.[4]
C’est important lorsqu’un résultat de recherche te dirige vers l’installation de la CLI ou des étapes de changement d’équipe. Confirme que ces étapes s’appliquent au produit et au processus qui reçoivent l’erreur. Un profil CLI fonctionnel ne permet pas, à lui seul, d’établir quels identifiants utilise ton service web déployé séparément.
Pour les applications dans le navigateur, fal recommande de garder la clé derrière un proxy côté serveur.[2] Mettre le secret dans le code du navigateur ne résout pas un verrouillage de compte. Vérifie les identifiants réellement utilisés par le proxy et l’erreur renvoyée, en gardant l’authentification côté serveur.
Donne au support un compte et une séquence à examiner
Pour un verrouillage inexpliqué, le mainteneur recommande de contacter le support de fal en utilisant la même adresse e-mail que celle du compte concerné. Les cas de verrouillage sont traités individuellement ; un commentaire public dans une issue ne peut pas effectuer le déverrouillage.[1]
Un bref signalement privé peut suivre ce modèle :
Compte : [compte concerné]. À [heure UTC], [opération et endpoint] a renvoyé [erreur complète expurgée]. L’application utilise [identifiant sûr des identifiants] appartenant au [compte ou à l’équipe]. À [heure de capture], ce compte affichait [solde]. L’achat [référence], le cas échéant, a été enregistré à [heure]. La requête [ID], si elle existe, a été acceptée avant l’erreur ultérieure. Merci d’examiner la restriction du compte et l’opération indiquée ici.
Ajoute le nom et la version du client, et indique les vérifications déjà effectuées. Supprime l’en-tête d’autorisation, la clé API et les détails de paiement inutiles. Décris simplement les observations : la clé utilisée, la réponse reçue et le solde affiché. N’attribue pas aux données une panne de base de données ou un motif de facturation qu’elles n’établissent pas.
Lis la réponse la plus récente du mainteneur dans toute issue que tu utilises comme contexte. Un rapport distinct, l’issue 1163, a été fermé après qu’un mainteneur a indiqué que le support avait déjà résolu le problème de ce compte.[5] Cela ne prouve pas que tous les comptes sont rétablis, tout comme le rapport initial ne prouve pas qu’une panne est encore en cours. Aucun délai d’attente universel ni aucune promesse de remboursement ne peut être déduit de l’un ou l’autre fil.
Si le support indique que le compte est déverrouillé, reviens à l’opération qui a échoué. Dans le cas hypothétique d’un travail accepté suivi d’une interrogation refusée, vérifie d’abord cette requête existante. Le rétablissement de l’accès peut te permettre d’en récupérer l’état ; il ne garantit pas que la génération elle-même a réussi. Enregistre la nouvelle réponse à côté de l’ancien message de verrouillage. Si la même opération échoue encore, envoie l’horodatage mis à jour et la réponse dans la conversation de support existante afin que l’examen porte sur l’état actuel du compte.
Lorsque l’accès revient, examine le travail mis en pause avant de le reprendre. Sépare les soumissions refusées des tâches qui ont déjà reçu des identifiants, et inspecte ces dernières avant de les recréer. Une génération utilisée pour tester le rétablissement de l’accès peut entraîner des frais si elle est acceptée ; cet article n’a pas effectué un tel test. Ne reprends que le travail que tu souhaites toujours effectuer, en consignant le compte et l’identifiant corrigés.
Conservez ces vérifications si vous changez de fournisseur
Si ce blocage vous pousse à évaluer un autre fournisseur, vérifiez qu’il distingue aussi les problèmes d’identifiants des problèmes de financement. Sur reAPI, une clé invalide renvoie HTTP 401 avec le code 10003, une clé révoquée renvoie 10004, et un crédit insuffisant renvoie HTTP 402 avec le code 30001.[6] Un worker peut lire le solde du compte associé à sa clé avec GET /api/v1/balance, sans lancer de génération.[7]
Des codes clairs ne remplacent pas les habitudes décrites plus haut. Conservez la réponse complète, l’heure et l’opération en échec, et vérifiez à quel compte appartient la clé déployée avant d’ajouter du crédit.
Références
- fal-ai/fal. Issue 922 : compte verrouillé malgré un solde positif, fil complet comprenant les conseils du mainteneur. Consulté le 15 novembre 2026.
- fal. FAQ des Model APIs. Consulté le 15 novembre 2026.
- fal. Authentification par clé : autorisations, modèles autorisés et expiration. Consulté le 15 novembre 2026.
- fal. Installation et configuration : accès aux Model APIs et à Serverless. Consulté le 15 novembre 2026.
- fal-ai/fal. Issue 1163 : le compte est de nouveau verrouillé pour solde épuisé malgré un solde positif, résolution du mainteneur incluse. Consulté le 15 novembre 2026.
- reAPI. Erreurs. Vérifié le 17 novembre 2026. Codes d’erreur.
- reAPI. Solde. Vérifié le 17 novembre 2026. Référence du solde.