GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Alle Anleitungen

· reAPI Team

fal-Fehler „User is locked“: Konto, Key und Guthaben prüfen

Untersuche fal-Fehler „User is locked“, indem du Antwort, Konto, Guthaben und Schlüsselberechtigungen prüfst. Sichere Support-Nachweise, bevor du es erneut versuchst oder mehr bezahlst.

fal-Fehler „User is locked“: Konto, Key und Guthaben prüfen

User is locked kann auch nach einer Aufladung weiterhin auftreten. In fal-issue 922 beschrieben Nutzer diese Diskrepanz: Das Dashboard zeigte Guthaben an, während Anfragen weiterhin eine Sperrantwort erhielten. Der Thread enthält Berichte über unterschiedliche Lösungen und Fehlschläge; der Maintainer verwies betroffene Nutzer schließlich an den kontospezifischen Support.[1]

Aus diesem Verlauf geht die Ursache deines Fehlers nicht hervor. Er erklärt aber, warum „mehr Geld einzahlen“ oder „einen weiteren Schlüssel erstellen“ keine vollständige Antwort ist. Prüfe zuerst den vollständigen von der API zurückgegebenen Grund, das Konto hinter der laufenden Anwendung und den Zeitpunkt des Fehlers. Pausiere die automatischen Übermittlungen der Anwendung, solange diese Fakten ungeklärt sind.

Das Wort nach „Reason“ beibehalten

Eine Meldung über aufgebrauchtes Guthaben und eine Meldung über eine administrative Sperre sollten nicht zu demselben Protokolleintrag zusammengefasst werden. Bewahre den vollständigen Antworttext mit HTTP-Status, Endpunkt, Methode und Zeitstempel auf. Ein Protokoll, das nur 403 enthält, hat Informationen verworfen, die du für die nächste Entscheidung brauchst.

Ermittle dann, welcher Vorgang fehlgeschlagen ist. Hat die Anwendung eine neue Generierung übermittelt, eine bereits angenommene Anfrage geprüft oder versucht, deren Ergebnis abzurufen? Eine SDK-Ausnahme, die am Ende eines Workflows angezeigt wird, kann aus jedem dieser Schritte stammen. Die Abhilfe hängt davon ab, bei welchem Schritt die Ablehnung tatsächlich einging.

Betrachte eine hypothetische Abfolge: Die Übermittlung gibt eine Anfrage-ID zurück, der Worker speichert sie, und eine spätere Abfrage erhält den Sperrfehler. Diese Abfolge beweist nicht, dass die frühere Generierung fehlgeschlagen ist oder abgebrochen wurde. Bewahre die ID und die Antworten beider Vorgänge auf. Den gesamten Workflow erneut abzuspielen würde eine neue Übermittlung erzeugen, ohne das Ergebnis der bestehenden Anfrage zu klären.

Wenn dagegen die erste Übermittlung abgelehnt wurde und keine Anfrage-ID einging, halte genau dieses Ergebnis fest. Erfinde keine Aufgabenkennung und leite aus der Autorisierungsnachricht keinen endgültigen Generierungsstatus ab. Du untersuchst, ob der Vorgang erlaubt war, und bewertest noch nicht die Qualität der generierten Medien.

Der Leitfaden zu abgeschlossenen fal-Status behandelt den gesonderten Fall, in dem eine bekannte Anfrage einen Endstatus erreicht, aber ihre Medien fehlen. Wenn du diese Fälle auseinanderhältst, wird aus einem Kontoproblem keine unnötige erneute Generierung.

Das Konto prüfen, bevor du den Kontostand deutest

In den fal-FAQ steht, dass Konten gesperrt werden, wenn ihr Guthaben unter die Kontosperrschwelle fällt. Für diesen Fall wird eine Aufladung empfohlen; die Rechnungsstellung für Unternehmenskunden wird getrennt behandelt.[2] Die Regel besagt nicht allgemein, dass ein beliebiger angezeigter positiver Betrag den Zugriff für jedes Konto garantiert.

Ordne zunächst das Konto, dem der Schlüssel der Anwendung gehört, dem im Dashboard ausgewählten Konto zu. Beziehe gegebenenfalls auch den Teamkontext ein. Im Browser kann ein finanziertes Team angezeigt werden, während ein Worker einen persönlichen Schlüssel verwendet. Das ist eine zu prüfende Möglichkeit bei der Fehlersuche, aber keine von uns bestätigte Erklärung für deine Anfrage.

Prüfe die Konfiguration des laufenden Prozesses mit deinen üblichen Werkzeugen zur Geheimnisverwaltung. Ein Schlüsselname oder eine sichere Kennung kann helfen, die Quelle zu bestätigen, ohne das Geheimnis auszugeben. Wenn jemand kürzlich die Zugangsdaten geändert hat, stelle sicher, dass die Bereitstellung tatsächlich die vorgesehene Konfiguration geladen hat. Eine lokale Umgebungsdatei zu aktualisieren belegt nicht, was ein separater Worker verwendet.

Vergleiche die Beobachtung des Kontostands und den Fehler anhand bekannter Zeitpunkte. Ein Screenshot, der beispielsweise vor der Aufladung aufgenommen wurde, zeigt nicht, ob sich der Kontostand bis zum späteren Fehlschlag der Anfrage geändert hatte. Halte Eingangszeit, Aufnahmezeit des Dashboards und Zeitpunkt des fehlgeschlagenen Vorgangs gemeinsam fest. So erhält der Support eine überprüfbare Abfolge statt zweier undatierter Screenshots.

Wenn der Kontostand des betroffenen Kontos und der zurückgegebene Grund zum dokumentierten Einzahlungsschwellenwert passen, befolge diese Abrechnungshinweise. Wenn ein abgeschlossener Kauf fehlt, untersuche den Kauf- und Guthabeneintrag. Wenn das richtige Konto Guthaben anzeigt, die Sperre aber ungeklärt bleibt, ist eine weitere Einzahlung kein Beleg dafür, dass sich das Problem dadurch löst.

Eine Anmeldung im Dashboard ist ebenfalls ein anderer Vorgang als der API-Zugriff. Wenn du dich nicht mit GitHub anmelden kannst, weil der Einmalcode nie ankommt, empfiehlt die fal-FAQ, die primäre E-Mail-Adresse des GitHub-Kontos zu prüfen.[2] Das kann dir den Zugriff auf die Kontoseite ermöglichen; es erklärt nicht, warum eine bereits konfigurierte Anwendung eine Kontosperrantwort erhält.

Auch bei gedecktem Konto kann die Schlüsselrichtlinie falsch sein

fal dokumentiert Berechtigungsvoreinstellungen, benutzerdefinierte Berechtigungslisten, Einschränkungen zulässiger Modelle und den Ablauf von Schlüsseln. Die API-Voreinstellung ist für die Nutzung gehosteter Modelle gedacht.[3] Diese Einstellungen bestimmen, was die Zugangsdaten dürfen. Ein Kontostand zeigt, welche Mittel vorhanden sind. Die Korrektur des einen bestätigt nicht das andere.

Vergleiche den genau fehlgeschlagenen Vorgang mit der Richtlinie des Schlüssels. Ist der Schlüssel auf bestimmte Modelle beschränkt, prüfe den vorgesehenen Endpunkt anhand dieser Einschränkung. Ist er abgelaufen, korrigiere die Zugangsdaten, statt Guthaben hinzuzufügen. Sendet ein Client einen anderen als den erwarteten Schlüssel, korrigiere diese Konfiguration, bevor du die Kontoberechtigungen änderst.

Leicht zu übersehen ist, wie die Richtlinie erstellt wurde. Laut fal folgt ein voreingestellter Schlüssel der aktuellen Voreinstellungsdefinition, während eine benutzerdefinierte Richtlinie ihre Berechtigungsliste ab dem Erstellungszeitpunkt beibehält. Durch das Hinzufügen einer Modelleinschränkung wird der Schlüssel als benutzerdefinierte Richtlinie gespeichert.[3] Deshalb können zwei Schlüssel für dieselbe Anwendung eine getrennte Prüfung verdienen, statt anzunehmen, dass ihre Berechtigungen identisch bleiben.

Gewähre nicht jedem Schlüssel vollständigen Zugriff, nur um zu sehen, ob sich der Fehler ändert. Erteile die Berechtigungen für die Vorgänge, die die Anwendung benötigt, und halte die vorherige Richtlinie in deinen Untersuchungsnotizen fest. Wenn eine Anfrage nach mehreren gleichzeitigen Änderungen erfolgreich ist, weißt du nicht, welche Änderung ausschlaggebend war – und lässt möglicherweise umfassendere Zugriffsrechte bestehen, als die Anwendung benötigt.

Ebenso ist das Ersetzen eines Schlüssels kein dokumentierter allgemeingültiger Vorgang zum Entsperren eines Kontos. In issue 922 berichteten einige Nutzer von Erfolgen nach einem neuen Schlüssel oder einer SDK-Aktualisierung, während andere sagten, dass diese Schritte nicht funktionierten.[1] Das sind individuelle Beobachtungen. Sie belegen nicht, dass eine SDK-Version, Schlüssel-Migration oder verzögerte Entsperrung die Ursache jeder ähnlichen Meldung ist.

Wenn du zwei Clients vergleichst, stimme zuerst das vorgesehene Konto, Modell und den Vorgang ab. Eine erfolgreiche Anfrage von einem Laptop für ein Modell belegt nicht den Zugriff eines geplanten Workers auf ein anderes Modell. Halte die verbleibenden Unterschiede fest, bevor du eine Korrektur auswählst. Andernfalls kann eine Änderung am Modell oder Konto fälschlich als Behebung eines Problems mit der Clientbibliothek gelten.

Prüfe die installierte Clientversion und den Aufbau der Anfrage, wenn die Belege darauf hindeuten. Bewahre vor Änderungen an Paketen die vollständige Serviceantwort auf. So kannst du eine Korrektur der Clientkonfiguration von einer Kontobeschränkung unterscheiden, die die Aufmerksamkeit des Anbieters erfordert.

Gehostete Modelle und Serverless-Bereitstellung erfordern unterschiedliche Prüfungen

Wenn du nur die gehosteten Model APIs von fal aufrufst, benötigst du laut Installationsanleitung einen API-Schlüssel und das Client-SDK, nicht jedoch die Serverless CLI. Die Bereitstellung eigener Serverless-Apps erfordert eine Kontogenehmigung; für den Aufruf gehosteter Model APIs ist diese Genehmigung nicht erforderlich.[4]

Das ist wichtig, wenn dich ein Suchergebnis zur Installation der CLI oder zum Wechsel des Teams führt. Bestätige, dass diese Schritte für das Produkt und den Prozess gelten, bei denen der Fehler auftritt. Ein funktionierendes CLI-Profil belegt für sich genommen nicht, welche Zugangsdaten dein separat bereitgestellter Webdienst verwendet.

Für Browseranwendungen empfiehlt fal, den Schlüssel hinter einem serverseitigen Proxy aufzubewahren.[2] Das Geheimnis in Browsercode einzufügen, behebt keine Kontosperre. Prüfe die tatsächlich vom Proxy verwendeten Zugangsdaten und den zurückgegebenen Fehler; die Authentifizierung muss auf dem Server bleiben.

Dem Support ein Konto und einen Ablauf zur Prüfung nennen

Bei einer ungeklärten Sperre lautet die Anweisung des Maintainers, den fal-Support mit derselben E-Mail-Adresse wie für das betroffene Konto zu kontaktieren. Sperrfälle werden individuell behandelt; ein öffentlicher Issue-Kommentar kann die Sperre nicht aufheben.[1]

Ein knapper privater Bericht kann diesem Muster folgen:

Konto: [betroffenes Konto]. Um [UTC-Zeit] gab [Vorgang und Endpunkt] den [vollständigen bereinigten Fehler] zurück. Die Anwendung verwendet [sichere Kennung der Zugangsdaten] des [Kontos oder Teams]. Zum Zeitpunkt [der Aufnahme] zeigte dieses Konto [Kontostand] an. Der Kauf [Referenz] wurde, falls relevant, um [Zeit] verbucht. Die Anfrage [ID] wurde, falls vorhanden, vor dem späteren Fehler angenommen. Bitte prüft die Kontobeschränkung und den hier gezeigten Vorgang.

Füge Clientnamen und Version hinzu und nenne die Prüfungen, die du bereits abgeschlossen hast. Entferne den Autorisierungsheader, den API-Schlüssel und unnötige Zahlungsangaben. Beschreibe Beobachtungen sachlich: den verwendeten Schlüssel, die erhaltene Antwort und den angezeigten Kontostand. Weise diesen Aufzeichnungen keine Datenbankstörung oder Abrechnungsabsicht zu, die sie nicht belegen.

Lies die neueste Antwort des Maintainers in jedem Issue, das du als Hintergrund nutzt. Ein separater Bericht, issue 1163, wurde geschlossen, nachdem ein Maintainer mitgeteilt hatte, dass der Support das Konto bereits zuvor gelöst hatte.[5] Das beweist nicht, dass jedes Konto wiederhergestellt ist, genauso wenig wie der ursprüngliche Bericht beweist, dass der Ausfall jetzt noch andauert. Aus keinem der beiden Threads lässt sich eine allgemeingültige Wartezeit oder Rückerstattungszusage ableiten.

Wenn der Support sagt, dass das Konto entsperrt ist, kehre zu dem fehlgeschlagenen Vorgang zurück. Prüfe bei dem hypothetischen Fall eines angenommenen Jobs mit anschließend abgelehnter Abfrage zuerst die bestehende Anfrage. Der wiederhergestellte Zugriff kann es dir ermöglichen, ihren Status abzurufen; er garantiert nicht, dass die Generierung selbst erfolgreich war. Speichere die neue Antwort neben der früheren Sperrmeldung. Schlägt derselbe Vorgang weiterhin fehl, sende den aktualisierten Zeitstempel und die Antwort im bestehenden Support-Gespräch, damit die Prüfung den aktuellen Kontostatus betrifft.

Wenn der Zugriff wiederhergestellt ist, prüfe die pausierten Arbeiten, bevor du sie fortsetzt. Trenne abgelehnte Übermittlungen von Jobs, die bereits IDs erhalten haben, und prüfe Letztere, bevor du sie neu erstellst. Eine Generierung zum Test des wiederhergestellten Zugriffs kann Kosten verursachen, wenn sie angenommen wird; dieser Artikel hat keinen solchen Test durchgeführt. Setze nur die Arbeiten fort, die du weiterhin ausführen möchtest, und halte das korrigierte Konto sowie die Zugangsdaten fest.

Diese Prüfungen auch nach einem Wechsel beibehalten

Wenn die Sperre Sie dazu bringt, einen anderen Anbieter zu prüfen, achten Sie auf dieselbe Trennung zwischen Zugangsdaten und Guthaben. Bei reAPI liefert ein ungültiger Key HTTP 401 mit dem Code 10003, ein widerrufener Key 10004 und fehlendes Guthaben HTTP 402 mit dem Code 30001.[6] Ein Worker kann mit GET /api/v1/balance das Guthaben des Kontos hinter seinem Key abfragen, ohne eine Generierung zu starten.[7]

Klare Codes ersetzen die oben beschriebenen Gewohnheiten nicht. Bewahren Sie die vollständige Antwort, den Zeitpunkt und den fehlgeschlagenen Vorgang auf, und prüfen Sie vor dem Aufladen, zu welchem Konto der eingesetzte Key gehört.

Quellen

  1. fal-ai/fal. Issue 922: Konto trotz positivem Kontostand gesperrt, vollständiger Thread einschließlich der Hinweise des Maintainers. Abgerufen am 15. November 2026.
  2. fal. Model APIs FAQ. Abgerufen am 15. November 2026.
  3. fal. Schlüsselbasierte Authentifizierung: Berechtigungen, zulässige Modelle und Ablauf. Abgerufen am 15. November 2026.
  4. fal. Installation und Einrichtung: Zugriff auf Model APIs und Serverless. Abgerufen am 15. November 2026.
  5. fal-ai/fal. Issue 1163: Konto wird wegen erschöpften Guthabens trotz positivem Kontostand erneut gesperrt, einschließlich der Lösung durch den Maintainer. Abgerufen am 15. November 2026.
  6. reAPI. Fehler. Geprüft am 17. November 2026. Fehlercodes.
  7. reAPI. Guthaben. Geprüft am 17. November 2026. Guthaben-Referenz.
Alle Anleitungen