WaveSpeedAI

fal.ai „User is locked“ (Admin lock, Exhausted balance): Was es bedeutet und was zu tun ist

Ihr fal.ai-Schlüssel liefert 403 „User is locked. Reason: Admin lock“ oder „Exhausted balance“. Was die einzelnen Gründe bedeuten, wie Sie die Sperre aufheben lassen und wie Ihre App in der Zwischenzeit weiterläuft.

By WaveSpeedAI11 min read

Wenn Ihre Anfragen an fal.ai plötzlich mit 403 fehlschlagen und im Body User is locked steht, liegt die Sperre an Ihrem Konto, nicht an Ihrer Anfrage. Wiederholungen heben sie nicht auf, und nach den meisten Berichten hilft auch ein neuer API-Key nicht. Was Sie als Nächstes tun, hängt vom Grund in der Meldung ab: Exhausted balance ist eine Abrechnungssperre, die eine Aufladung aufheben soll. Admin lock ist eine Sperre auf Seiten von fal, die nur der fal-Support entfernen kann.

Dieser Leitfaden erklärt, was die einzelnen Gründe bedeuten, in welcher Reihenfolge Sie vorgehen, damit Ihr Konto am schnellsten wieder freigeschaltet wird, und wie Sie Ihr Produkt während der Wartezeit am Laufen halten.

Geprüfte Quellen (Stand: 22. November 2026): die Dokumentation von fal und der öffentliche Issue-Tracker des Repositorys fal-ai/fal auf GitHub.

Wie der Fehler aussieht

Die API antwortet mit HTTP 403 und einem detail-String. Diese drei Varianten tauchen in öffentlichen Berichten auf:

{"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."}
Grund in der MeldungBedeutungWer kann die Sperre aufheben
Exhausted balanceAbrechnungssperre. In den FAQ von fal heißt es: „Wenn Ihr Guthaben unter den Sperrschwellenwert Ihres Kontos fällt, wird Ihr Konto gesperrt und API-Anfragen werden abgelehnt.“Sie selbst, indem Sie Guthaben aufladen. Bleibt das Konto nach der Aufladung gesperrt, der fal-Support.
TOP_UPIn der Dokumentation von fal nicht beschrieben. In Berichten erscheint er beim selben Konto neben der Meldung Exhausted balance, behandeln Sie ihn daher als dieselbe Abrechnungssperre.Wie oben.
Admin lockEine Sperre auf Seiten von fal. Die Meldung selbst fordert Sie auf, den Support zu kontaktieren. fal veröffentlicht die Kriterien nicht.Nur der fal-Support.

Zwei Details sollten Sie kennen, bevor Sie loslegen:

  • Die FAQ sprechen von einem Sperr-Schwellenwert, nicht von null. Ein Dashboard, das noch ein paar Dollar anzeigt, beweist nicht, dass Sie über dem Schwellenwert Ihres Kontos liegen.
  • Laut denselben FAQ unterliegen Enterprise-Kunden mit Rechnungsstellung „nicht der automatischen Sperrung“. Wenn ein unterbrechungsfreier Betrieb wichtiger ist als die Flexibilität von Pay-as-you-go, fragen Sie fal nach diesem Tarif.

Ein anderer 403: „Access denied“

Nicht jeder 403 von fal ist eine Kontosperre. Steht im Body, dass der Zugriff verweigert wird oder Ihnen die Berechtigung für einen Endpoint fehlt, und gibt es keinen Text User is locked, dann ist das Konto offen, aber dieser Key oder dieser Endpoint ist nicht erlaubt. Die Authentifizierungsdokumentation von fal verknüpft 403-Fehler dieser Art mit dem Berechtigungs-Preset des API-Keys. Prüfen Sie, welchen Key der fehlschlagende Dienst verwendet und mit welchem Preset er erstellt wurde. Hat sich auf Ihrer Seite nichts geändert und lehnt eine ganze Endpoint-Familie plötzlich einen Key ab, der gestern noch funktionierte, ist das eine Frage an den fal-Support, mit der Endpoint-ID und dem vollständigen Fehler-Body.

Sie sind nicht allein

Im Issue-Tracker von fal-ai/fal gibt es mehr als 25 Issues zu gesperrten Konten, die zwischen März und November 2026 eröffnet wurden. Sie lassen sich in zwei Gruppen einteilen.

Gesperrt trotz positivem Guthaben. Nutzer berichten von der Sperre Exhausted balance, obwohl das Dashboard Guthaben anzeigt, zum Beispiel #922, #1112, #1163 und #1269. In #1163 schreibt der Melder, das Konto sei Minuten nach einer manuellen Entsperrung erneut gesperrt worden.

Admin lock kurz nach einer Aufladung. Mehrere Berichte beschreiben ein neues oder kaum genutztes Konto, das direkt nach der ersten Zahlung per Admin lock gesperrt wurde, zum Beispiel #1183, #1248, #1254 und #1281. Ein weiterer, #1061, stammt von einem Entwickler, dessen Nutzung bei End-to-End-Tests vor einem Launch sprunghaft anstieg.

Fairerweise gilt: Das sind Einzelberichte und kein Maß dafür, wie oft es vorkommt, und in den Threads bestätigen fal-Mitarbeiter, dass die Konten vom Support entsperrt wurden. Der Melder von #1281 wurde am Tag nach seiner E-Mail entsperrt. Andere Melder schreiben, sie hätten mehrere Tage auf eine erste Antwort gewartet. Mitarbeiter erklären in diesen Threads außerdem, dass GitHub nicht für den Konto-Support überwacht wird.

So werden Sie entsperrt, der Reihe nach

1. Grund lesen und Wiederholungen stoppen

Protokollieren Sie den vollständigen 403-Body. Ein gesperrtes Konto ist kein vorübergehender Fehler, nehmen Sie es daher aus Ihrem Retry-Pfad heraus. Wiederholungen bei einem gesperrten Konto füllen nur Ihre Queue und verzögern den Alarm, dass jemand handeln muss.

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:
        # Nicht wiederholbar: einen Menschen alarmieren und auf den Fallback-Anbieter umschalten.
        raise AccountLocked(resp.json().get("detail", resp.text))
    resp.raise_for_status()

2. Zuerst die Abrechnung prüfen

Öffnen Sie das Billing-Dashboard und prüfen Sie drei Dinge: das Guthaben, dass keine Rechnung offen ist und dass die Zahlungsmethode gültig ist. Lautet der Grund Exhausted balance oder TOP_UP, laden Sie Guthaben auf. Senden Sie dann einige Minuten später eine Testanfrage.

3. Den Support von der Konto-Adresse aus anschreiben

Lautet der Grund Admin lock oder übersteht eine Abrechnungssperre eine Aufladung, ist support@fal.ai der einzige Kanal, den fal nennt, und die Mitarbeiter bitten darum, von der E-Mail-Adresse des gesperrten Kontos zu schreiben. Packen Sie alles, was sie brauchen, in die erste Nachricht, damit keine Rückfrage nötig wird:

  • Die E-Mail-Adresse des Kontos und, falls Sie eines nutzen, den Namen des Teams.
  • Den exakten detail-String und den Zeitpunkt der ersten fehlgeschlagenen Anfrage.
  • Den Beleg oder die Rechnungsnummer Ihrer letzten Aufladung.
  • Ein bis zwei Sätze dazu, was Ihr Produkt macht und warum sich die Nutzung geändert hat, falls das der Fall war (ein Launch, ein Lasttest, ein neues Feature).

4. Was nicht hilft

  • Den API-Key rotieren. Die Sperre liegt am Konto. Melder, die einen neuen Key erstellt haben, erhielten denselben 403.
  • Ein zweites Konto eröffnen. Handelt es sich bei der Sperre um eine Zahlungs- oder Risikoprüfung, verlangsamt ein doppeltes Konto mit derselben Karte die Prüfung meist eher, statt sie zu beschleunigen.
  • Jeden Tag dieselbe E-Mail erneut senden. Antworten Sie stattdessen im bestehenden Thread, damit der Verlauf in einem Ticket bleibt.
  • Ein GitHub-Issue statt einer E-Mail eröffnen. Das kann die Sichtbarkeit erhöhen, aber Mitarbeiter schließen solche Issues und verweisen auf die E-Mail.

Wenn Sie ein Team sind: ein Konto, nicht ein Konto pro Person

In Community-Fragen taucht immer wieder dieses Muster auf: Ein Unternehmen gibt jedem Mitarbeiter ein persönliches Konto und finanziert alle mit derselben Karte. Viele neue Konten, die von einer Karte bezahlt werden, sind genau das, worauf Zahlungsrisikosysteme auf jeder Plattform ausgelegt sind. Der von fal dokumentierte Weg ist ein Team: ein gemeinsamer Workspace mit eigener Abrechnung, in dem „API-Keys dem Team gehören, nicht einzelnen Mitgliedern“ und Admins Mitglieder per E-Mail oder bei größeren Gruppen per CSV einladen. Waren Ihre Konten bereits auf diese Weise gesperrt, sagen Sie das in der Support-E-Mail offen und bitten Sie darum, sie in einem Team zusammenzuführen.

Halten Sie Ihr Produkt während der Wartezeit am Laufen

Eine Kontosperre ist der eine Fehler, den Wiederholungen, Backoff und ein zweiter API-Key nicht beheben können. Hängen zahlende Kunden von Ihrer Generierungs-Pipeline ab, besteht der praktische Schutz in einer zweiten Plattform, die dieselben Modellfamilien anbietet, bereits integriert und aufgeladen ist und auf die Sie per Konfigurations-Flag umschalten können.

Ein paar Regeln halten den Aufwand dafür gering:

  • Halten Sie die Modellauswahl hinter Ihrer eigenen Schnittstelle, sodass der Aufrufer „Text-zu-Bild, 1024 × 1024“ anfordert und nicht eine Anbieter-URL.
  • Klassifizieren Sie Fehler auf Kontoebene (gesperrt, suspendiert, kein Guthaben) getrennt von Fehlern auf Anfrageebene und wechseln Sie nur bei der ersten Art zum Fallback.
  • Leiten Sie täglich einen kleinen Anteil des echten Traffics über den Fallback. Ein Fallback, der einen Monat lang nicht aufgerufen wurde, ist erfahrungsgemäß kaputt, wenn Sie ihn brauchen.

WaveSpeedAI als zweite Plattform nutzen

WaveSpeedAI ist eine Pay-as-you-go-API für Bild-, Video-, Audio- und 3D-Modelle. Der Modellkatalog deckt die Familien ab, die die meisten fal-Projekte nutzen, darunter Seedance, Kling, Wan, Veo, FLUX, Seedream und GPT Image. Das ist für dieses Problem wichtig:

  • Das Guthaben wird bei jeder Anfrage geprüft. Eine Anfrage wird angenommen, wenn das Konto genug Guthaben dafür hat. Nach einer Aufladung geht die nächste Anfrage durch; einen separaten Entsperrschritt, auf den Sie warten müssten, gibt es nicht.
  • Eine klare Meldung, wenn das Guthaben aufgebraucht ist. Die API gibt Insufficient credits. Please top up your account to continue zurück, sodass Ihr Code ein Abrechnungsproblem von einem Modellfehler unterscheiden kann.
  • Automatisches Aufladen. Sie können das Konto sich selbst aufladen lassen, sobald es unter einen von Ihnen gewählten Kontostand fällt. Das beseitigt die häufigste Ursache für einen Ausfall um 3 Uhr nachts.
  • Zahlungsoptionen. Karten, PayPal, Alipay und WeChat Pay.
  • Teammitglieder auf einem Konto. Laden Sie Teamkollegen über das Dashboard ein, damit alle mit demselben Guthaben arbeiten statt mit getrennten persönlichen Konten.
  • Preis vor der Ausführung sichtbar. Jede Modellseite zeigt die Kosten der Anfrage, die Sie konfiguriert haben.

Wie jede Plattform hat WaveSpeedAI Nutzungsbedingungen und Inhaltsregeln, lesen Sie diese daher, bevor Sie Produktions-Traffic umziehen.

Wie eine Anfrage aussieht

Senden Sie eine Aufgabe ab und rufen Sie dann das Ergebnis mit der zurückgegebenen ID ab. Das Beispiel verwendet ein schnelles Text-zu-Bild-Modell; jedes Modell im Katalog folgt denselben zwei Aufrufen.

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"

Der erste Aufruf liefert data.id. Der zweite liefert data.status (created, processing, completed oder failed) und, sobald die Aufgabe abgeschlossen ist, die Datei-URLs in data.outputs.

Zuordnung von fal

Bei falBei WaveSpeedAI
An den Queue-Endpoint eines Modells sendenPOST https://api.wavespeed.ai/api/v3/<model path>
Den Anfragestatus abfragen, dann das Ergebnis abrufenGET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Header Authorization: Key ...Header Authorization: Bearer ...
Webhook bei AbschlussUnterstützt; siehe die Dokumentation
Python- und JavaScript-ClientsPython- und JavaScript-SDKs sowie reines REST

Bei manchen Modellen unterscheiden sich die Eingabenamen zwischen den Plattformen. Prüfen Sie daher die Parameterliste auf der jeweiligen Modellseite, statt einen Payload einfach zu übernehmen.

Wenn Sie lieber im Browser testen möchten, bevor Sie Code schreiben: Der Bildgenerator und der Videogenerator führen dieselben Modelle aus wie die API.

FAQ

Was bedeutet „User is locked. Reason: Admin lock“ bei fal.ai?

Es bedeutet, dass das Konto auf Seiten von fal gesperrt wurde und nicht durch die automatische Guthabenprüfung. Die Meldung fordert Sie auf, support@fal.ai zu kontaktieren. Weder Aufladen noch ein neuer Key hebt die Sperre auf; das muss der fal-Support tun.

Warum ist mein fal-Konto mit „Exhausted balance“ gesperrt, obwohl ich noch Guthaben habe?

Laut den FAQ von fal greift die Sperre, wenn das Guthaben unter einen kontospezifischen Sperrschwellenwert fällt, der nicht unbedingt null ist. Unabhängig davon beschreiben mehrere öffentliche Berichte, dass die Sperre nach einer erfolgreichen Aufladung bestehen blieb und der Support sie in diesen Fällen manuell aufgehoben hat. Laden Sie auf, warten Sie ein paar Minuten, testen Sie einmal und schreiben Sie dann dem Support.

Wie lange braucht fal, um ein Konto zu entsperren?

Eine Zeitangabe gibt es nicht. In den öffentlichen Threads wurden einige Nutzer innerhalb eines Tages nach ihrer E-Mail entsperrt, andere berichten, mehrere Tage auf eine erste Antwort gewartet zu haben. Planen Sie mit dem längeren Fall.

Warum gibt fal „Access denied“ oder „You do not have permission to use this endpoint“ zurück?

Das ist ein Berechtigungsfehler, keine Kontosperre. Prüfen Sie das Berechtigungs-Preset des API-Keys, den die Anfrage verwendet hat. Haben sich Key und Code nicht geändert, senden Sie dem fal-Support die Endpoint-ID und den Fehler-Body.

Können mehrere fal-Konten mit einer Karte gesperrt werden?

fal veröffentlicht seine Risikoregeln nicht. Viele Konten, die von einer einzigen Karte finanziert werden, sind generell ein häufiger Auslöser für Zahlungsrisikoprüfungen, und fal bietet Teams an, um ein Abrechnungskonto für mehrere Personen gemeinsam zu nutzen. Verwenden Sie daher stattdessen ein Team.

Hilft ein neuer API-Key oder ein neues Konto?

Ein neuer Key nicht, denn die Sperre liegt am Konto. Ein neues Konto ist keine gute Idee, solange das erste noch geprüft wird.

Wie vermeide ich Ausfallzeiten durch eine Kontosperre auf jeder Plattform?

Halten Sie einen zweiten Anbieter integriert und aufgeladen, behandeln Sie Fehler auf Kontoebene als nicht wiederholbar und wechseln Sie bei ihnen automatisch zum Fallback. Aktivieren Sie, wo die Plattform es anbietet, das automatische Aufladen, damit ein niedriger Kontostand gar nicht erst zur Sperre wird.

Teilen