WaveSpeedAI

fal.ai « User is locked » (Admin lock, Exhausted balance) : ce que cela signifie et que faire

Votre clé fal.ai renvoie l'erreur 403 « User is locked. Reason: Admin lock » ou « Exhausted balance ». Ce que signifie chaque motif, comment faire lever le blocage et comment garder votre application opérationnelle en attendant.

By WaveSpeedAI12 min read

Si vos requêtes fal.ai échouent soudainement avec un 403 et que le corps indique User is locked, le blocage vise votre compte, pas votre requête. Réessayer ne le lèvera pas et, dans la plupart des signalements, une nouvelle clé API ne le lève pas non plus. La suite dépend de la raison indiquée dans le message : Exhausted balance est un verrou de facturation qu’une recharge est censée lever, et Admin lock est un verrou posé côté fal que seul le support de fal peut retirer.

Ce guide explique ce que signifie chaque raison, l’ordre des démarches qui permet de débloquer un compte le plus vite possible, et comment garder un produit en service pendant l’attente.

Sources vérifiées le 22 novembre 2026 : la documentation de fal et le suivi public des tickets du dépôt fal-ai/fal sur GitHub.

À quoi ressemble l’erreur

L’API répond par un HTTP 403 accompagné d’une chaîne detail. Voici les trois variantes qui apparaissent dans les signalements publics :

{"detail": "User is locked. Reason: Exhausted balance. Top up your balance at fal.ai/dashboard/billing."}
{"detail": "User is locked. Reason: Admin lock. Please contact support@fal.ai."}
{"detail": "User is locked. Reason: TOP_UP."}
Raison dans le messageSignificationQui peut le lever
Exhausted balanceVerrou de facturation. La FAQ de fal indique : « When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected. »Vous, en ajoutant des crédits. Si le compte reste verrouillé après la recharge, le support de fal.
TOP_UPNon décrit dans la documentation de fal. Dans les signalements, il apparaît à côté du message Exhausted balance sur le même compte ; considérez-le donc comme le même verrou de facturation.Idem.
Admin lockVerrou posé côté fal. Le message lui-même vous demande de contacter le support. fal ne publie pas ses critères.Le support de fal uniquement.

Deux précisions utiles avant de commencer :

  • La FAQ parle d’un seuil de verrouillage, pas de zéro. Un tableau de bord qui affiche encore quelques dollars ne prouve pas que vous êtes au-dessus du seuil de votre compte.
  • La même FAQ précise que les clients entreprise facturés sur facture « are not subject to automatic locking ». Si la continuité de service compte plus que la souplesse du paiement à l’usage, c’est l’offre à demander à fal.

Un autre 403 : « Access denied »

Tous les 403 de fal ne sont pas des verrouillages de compte. Si le corps indique que l’accès est refusé ou que vous n’avez pas l’autorisation d’utiliser un endpoint, sans texte User is locked, le compte est ouvert mais cette clé ou cet endpoint n’est pas autorisé. La documentation d’authentification de fal relie ce type de 403 au préréglage de permissions de la clé API. Vérifiez quelle clé utilise le service en échec et avec quel préréglage elle a été créée. Si rien n’a changé de votre côté et qu’une famille entière d’endpoints refuse une clé qui fonctionnait hier, c’est une question pour le support de fal, avec l’identifiant de l’endpoint et le corps complet de l’erreur.

Vous n’êtes pas le seul

Le suivi des tickets de fal-ai/fal compte plus de 25 tickets sur des comptes verrouillés, ouverts entre mars et novembre 2026. Ils se répartissent en deux groupes.

Verrouillé avec un solde positif. Des utilisateurs signalent le verrou Exhausted balance alors que le tableau de bord affiche des crédits, par exemple #922, #1112, #1163 et #1269. Dans #1163, l’auteur écrit que le compte s’est reverrouillé quelques minutes après un déblocage manuel.

Admin lock peu après une recharge. Plusieurs signalements décrivent un compte neuf ou peu utilisé verrouillé par l’administration juste après son premier paiement, par exemple #1183, #1248, #1254 et #1281. Un autre, #1061, vient d’un développeur dont l’usage a explosé pendant des tests de bout en bout avant un lancement.

Par honnêteté envers fal : il s’agit de signalements individuels, pas d’une mesure de la fréquence du problème, et dans les discussions le personnel de fal confirme que les comptes ont été débloqués par le support. L’auteur de #1281 a été débloqué le lendemain de son e-mail. D’autres disent avoir attendu plusieurs jours avant une première réponse. Le personnel indique aussi dans ces discussions que GitHub n’est pas surveillé pour le support des comptes.

Comment se faire débloquer, dans l’ordre

1. Lire la raison et cesser les nouvelles tentatives

Journalisez le corps complet du 403. Un compte verrouillé n’est pas une panne transitoire : retirez-le donc de votre chemin de relance. Réessayer sur un compte verrouillé ne fait que remplir votre file d’attente et retarder l’alerte indiquant que quelqu’un doit agir.

import requests

class AccountLocked(Exception):
    pass

def check_fal_response(resp: requests.Response) -> None:
    if resp.status_code == 403 and "User is locked" in resp.text:
        # Non relançable : alerter un humain et basculer vers le fournisseur de secours.
        raise AccountLocked(resp.json().get("detail", resp.text))
    resp.raise_for_status()

2. Vérifier d’abord la facturation

Ouvrez le tableau de bord de facturation et confirmez trois points : le solde de crédits, l’absence de facture impayée et la validité du moyen de paiement. Si la raison est Exhausted balance ou TOP_UP, ajoutez des crédits. Envoyez ensuite une requête de test quelques minutes plus tard.

3. Écrire au support depuis l’adresse du compte

Si la raison est Admin lock, ou si un verrou de facturation survit à une recharge, le seul canal que fal indique est support@fal.ai, et le personnel demande que vous écriviez depuis l’adresse e-mail du compte verrouillé. Mettez tout ce dont ils ont besoin dans le premier message pour ne pas perdre un aller-retour :

  • L’e-mail du compte et, le cas échéant, le nom de l’équipe.
  • La chaîne detail exacte et l’heure de la première requête en échec.
  • Le reçu ou le numéro de facture de votre dernière recharge.
  • Une ou deux phrases sur ce que fait votre produit et sur la raison du changement d’usage, s’il y en a eu un (lancement, test de charge, nouvelle fonctionnalité).

4. Ce qui n’aide pas

  • Changer de clé API. Le verrou porte sur le compte. Les auteurs qui ont créé une nouvelle clé ont obtenu le même 403.
  • Ouvrir un second compte. Si le verrou relève d’un contrôle de paiement ou de risque, un compte en double avec la même carte ralentit généralement le contrôle au lieu de l’accélérer.
  • Renvoyer le même e-mail tous les jours. Répondez plutôt dans le fil existant, pour que l’historique reste dans un seul ticket.
  • Ouvrir un ticket GitHub à la place d’un e-mail. Cela peut donner de la visibilité, mais le personnel les ferme et renvoie vers l’e-mail.

Si vous êtes une équipe : un seul compte, pas un compte par personne

Un schéma qui revient dans les questions de la communauté : une entreprise donne un compte personnel à chaque employé et les alimente tous avec la même carte. De nombreux comptes neufs payés avec une seule carte, c’est exactement ce que les systèmes de contrôle des risques de paiement sont conçus pour repérer, sur n’importe quelle plateforme. La méthode documentée par fal est une équipe : un espace de travail partagé avec sa propre facturation, où « API keys belong to the team, not to individual members » et où les administrateurs invitent des membres par e-mail, ou par CSV pour les grands groupes. Si vos comptes ont déjà été verrouillés de cette façon, dites-le clairement dans l’e-mail au support et demandez à les regrouper dans une seule équipe.

Garder votre produit en service pendant l’attente

Un verrouillage de compte est la seule panne que les nouvelles tentatives, le backoff et une seconde clé API ne peuvent pas corriger. Si des clients payants dépendent de votre pipeline de génération, la protection pratique est une seconde plateforme qui sert les mêmes familles de modèles, déjà intégrée et approvisionnée, vers laquelle vous pouvez basculer avec un simple indicateur de configuration.

Quelques règles rendent cette maintenance peu coûteuse :

  • Gardez le choix du modèle derrière votre propre interface, afin que l’appelant demande « texte vers image, 1024 × 1024 » et non une URL de fournisseur.
  • Classez les erreurs de niveau compte (verrouillé, suspendu, sans crédits) séparément des erreurs de niveau requête, et ne basculez que sur la première catégorie.
  • Faites passer chaque jour une petite part du trafic réel par la solution de secours. Une solution de secours qui n’a pas été appelée depuis un mois est souvent cassée au moment où vous en avez besoin.

Utiliser WaveSpeedAI comme seconde plateforme

WaveSpeedAI est une API à l’usage pour des modèles d’image, de vidéo, d’audio et de 3D. Le catalogue de modèles couvre les familles que la plupart des projets fal utilisent, notamment Seedance, Kling, Wan, Veo, FLUX, Seedream et GPT Image. Les points qui comptent pour ce problème :

  • Les crédits sont vérifiés à chaque requête. Une requête est acceptée lorsque le compte dispose de assez de crédits pour elle. Après une recharge, la requête suivante passe ; il n’y a pas d’étape de déverrouillage distincte à attendre.
  • Un message clair lorsque les crédits sont épuisés. L’API renvoie Insufficient credits. Please top up your account to continue, ce qui permet à votre code de distinguer un problème de facturation d’un échec de modèle.
  • Recharge automatique. Vous pouvez laisser le compte se recharger lui-même sous un solde que vous choisissez, ce qui supprime la cause la plus courante de panne à 3 h du matin.
  • Moyens de paiement. Cartes, PayPal, Alipay et WeChat Pay.
  • Plusieurs membres sur un seul compte. Invitez vos coéquipiers depuis le tableau de bord pour que tout le monde travaille avec le même solde au lieu de comptes personnels séparés.
  • Prix affiché avant l’exécution. Chaque page de modèle indique le coût de la requête que vous avez configurée.

Comme toute plateforme, WaveSpeedAI a des conditions d’utilisation et des règles de contenu ; lisez-les avant de basculer du trafic de production.

À quoi ressemble une requête

Soumettez une tâche, puis récupérez le résultat avec l’identifiant renvoyé. L’exemple utilise un modèle texte vers image rapide ; chaque modèle du catalogue suit les deux mêmes appels.

curl --request POST 'https://api.wavespeed.ai/api/v3/wavespeed-ai/z-image/turbo' \
  --header "Authorization: Bearer $WAVESPEED_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"prompt": "A lighthouse on a cliff at sunrise, soft fog, 35mm photo"}'
curl --request GET "https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result" \
  --header "Authorization: Bearer $WAVESPEED_API_KEY"

Le premier appel renvoie data.id. Le second renvoie data.status (created, processing, completed ou failed) et, une fois terminé, les URL des fichiers dans data.outputs.

Correspondance avec fal

Sur falSur WaveSpeedAI
Soumission à l’endpoint de file d’attente d’un modèlePOST https://api.wavespeed.ai/api/v3/<model path>
Interrogation du statut de la requête, puis récupération du résultatGET https://api.wavespeed.ai/api/v3/predictions/<id>/result
En-tête Authorization: Key ...En-tête Authorization: Bearer ...
Webhook à la fin de la tâchePris en charge ; voir la documentation
Clients Python et JavaScriptSDK Python et JavaScript, ainsi que REST simple

Les noms des entrées diffèrent d’une plateforme à l’autre pour certains modèles ; vérifiez donc la liste des paramètres sur chaque page de modèle au lieu de copier une charge utile d’une plateforme à l’autre.

Si vous préférez tester dans un navigateur avant d’écrire du code, le générateur d’images et le générateur de vidéos exécutent les mêmes modèles que l’API.

FAQ

Que signifie « User is locked. Reason: Admin lock » sur fal.ai ?

Cela signifie que le compte a été verrouillé côté fal et non par la vérification automatique du solde. Le message vous demande de contacter support@fal.ai. Ajouter des crédits ou créer une nouvelle clé ne le lève pas ; seul le support de fal le peut.

Pourquoi mon compte fal est-il verrouillé avec « Exhausted balance » alors que j’ai encore des crédits ?

La FAQ de fal indique que le verrou se déclenche lorsque le solde passe sous un seuil de verrouillage propre au compte, qui n’est pas forcément zéro. Par ailleurs, plusieurs signalements publics décrivent un verrou qui persiste après une recharge réussie ; dans ces cas, le support l’a levé manuellement. Rechargez, attendez quelques minutes, testez une fois, puis écrivez au support.

Combien de temps fal met-il à débloquer un compte ?

Aucun délai n’est publié. Dans les discussions publiques, certains utilisateurs ont été débloqués dans la journée suivant leur e-mail et d’autres disent avoir attendu plusieurs jours avant une première réponse. Prévoyez le cas le plus long.

Pourquoi fal renvoie-t-il « Access denied » ou « You do not have permission to use this endpoint » ?

C’est une erreur de permission, pas un verrouillage de compte. Vérifiez le préréglage de permissions de la clé API utilisée par la requête. Si ni la clé ni votre code n’ont changé, envoyez au support de fal l’identifiant de l’endpoint et le corps de l’erreur.

Plusieurs comptes fal sur une même carte peuvent-ils être verrouillés ?

fal ne publie pas ses règles de risque. De nombreux comptes alimentés par une seule carte constituent en général un déclencheur courant des contrôles de risque de paiement, et fal propose des équipes pour partager un compte de facturation entre plusieurs personnes ; utilisez donc une équipe.

Une nouvelle clé API ou un nouveau compte réglera-t-il le problème ?

Une nouvelle clé non, car le verrou porte sur le compte. Un nouveau compte est une mauvaise idée tant que le premier est en cours d’examen.

Comment éviter une interruption de service due à un verrouillage de compte, quelle que soit la plateforme ?

Gardez un second fournisseur intégré et approvisionné, traitez les erreurs de niveau compte comme non relançables et basculez automatiquement dessus. Activez la recharge automatique lorsque la plateforme la propose, afin qu’un solde bas ne devienne jamais un verrouillage.

Partager