FlowModels

Fehlermeldungen von FlowModels verstehen

Veröffentlicht am 11. November 2026

Lehnt FlowModels eine Anfrage ab, bekommt deine Anwendung einen HTTP-Status und eine Fehlerbeschreibung im JSON-Format. Hier erfährst du, wie du eine Fehlermeldung liest und was die häufigsten Codes bedeuten.

So ist eine Fehlermeldung aufgebaut

Jede Fehlerantwort hat dieselbe Form, kompatibel zu OpenAI:

{
  "error": {
    "message": "…",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "param": null
  },
  "flowai_request_id": "01HXYZ…"
}

Entscheidend ist error.code. param nennt bei Eingabefehlern das betroffene Feld. Die flowai_request_id steht außerdem im Header x-request-id. Speichere sie in deinen Logs und gib sie bei Supportanfragen an. Dieselbe Kennung findest du im Anfrageprotokoll wieder.

429: Zu viele Anfragen oder kein Budget

Ein 429 hat zwei ganz verschiedene Ursachen. Schau deshalb immer auf den Code.

  • rate_limit_exceeded: Das Kontingent je Minute deiner Stufe oder das eigene Limit des Schlüssels ist ausgeschöpft. Warte so viele Sekunden, wie der Header Retry-After nennt, und versuche es erneut.
  • concurrent_requests_exceeded: Es laufen schon so viele Anfragen gleichzeitig, wie deine Stufe erlaubt. Schicke weniger parallel und wiederhole nach Retry-After. Mehr dazu in Anfragelimit: So funktionieren die Stufen.
  • insufficient_quota oder credit_balance_exhausted: Das verfügbare Guthaben reicht für diese Anfrage nicht. Lade Guthaben auf, siehe Guthaben aufladen und automatisch aufladen lassen.
  • spend_limit_exceeded oder period_spend_limit_exceeded: Das monatliche Limit des Schlüssels oder das Ausgabenlimit deines Teams ist erreicht. Eine Aufladung hilft hier nicht. Hebe das Limit an oder warte bis zum Monatswechsel, siehe Ausgabenlimit und Warnschwellen einrichten.

Wiederhole Anfragen mit Budgetfehlern nicht automatisch in einer Schleife. Sie scheitern so lange, bis du das Guthaben oder das Limit änderst.

503: Vorübergehend keine Kapazität

  • provider_overloaded: Der Anbieter des gewählten Modells hat gerade keine Kapazität. Das liegt nicht an deinem Konto. Warte die Sekunden aus Retry-After ab und versuche es erneut, oder weiche auf ein anderes Modell aus.
  • routing_unavailable: FlowModels ist vorübergehend abgeschaltet, zum Beispiel wegen Wartungsarbeiten. Es wird kein Guthaben reserviert. Wiederhole nach Retry-After.
  • pricing_unavailable: Für das Modell liegt gerade kein belastbarer Preis vor. Versuche es später erneut.

Bei 502 routing_execution_failed konnte die Anfrage nicht abgeschlossen werden, meist weil der Anbieter nicht geantwortet hat. Auch hier hilft oft eine spätere Wiederholung. FlowModels wechselt nicht selbst auf ein anderes Modell, sondern gibt den Fehler an dich weiter.

400: Die Anfrage ist fehlerhaft

Ein 400 bedeutet, dass etwas an deiner Anfrage nicht stimmt. Eine Wiederholung ohne Änderung bringt nichts.

  • invalid_field_value: Ein Feld hat einen ungültigen Wert oder ein Pflichtfeld fehlt. param nennt das Feld. Dazu zählt auch ein zu hoher Wert für max_tokens.
  • unsupported_for_model: Das Feld ist gültig, aber das gewählte Modell nimmt es nicht an, zum Beispiel temperature bei einem Modell mit festem Sampling. Welche Felder ein Modell versteht, liefert GET /v1/models.
  • unsupported_field: Das Feld wird von FlowModels generell nicht unterstützt.
  • input_tokens_exceeded oder context_length_exceeded: Die Eingabe ist zu groß für das Modell. Kürze den Verlauf oder die mitgeschickten Inhalte.

401, 403, 404 und 410

  • 401 invalid_api_key: Der Schlüssel ist unbekannt, abgelaufen oder gesperrt. Prüfe ihn unter API-Schlüssel.
  • 401 invalid_token_source: Der Schlüssel wurde nicht im Header Authorization: Bearer übergeben.
  • 403 insufficient_key_scope: Der Schlüssel hat die falsche Berechtigung, zum Beispiel Schlüssel verwalten statt KI nutzen für einen Modellaufruf.
  • 403 account_suspended: Der Zugang deines Teams zur FlowModels ist gesperrt. In der Abrechnung steht dann Zugang gesperrt. Wende dich an den Support.
  • 404 model_not_found: Die Modellkennung gibt es nicht. Prüfe sie unter Modelle.
  • 410 model_deprecated: Das Modell ist abgekündigt und nicht mehr aufrufbar. Stelle auf ein anderes Modell um.

Gut zu wissen

Die vollständige Liste aller Codes steht in der Dokumentation unter https://flowmodels.one/docs. Wenn du POST-Anfragen nach einem Verbindungsabbruch wiederholst, sende einen festen Idempotency-Key pro Vorgang mit. So wird eine Anfrage, die schon erfolgreich war, nicht ein zweites Mal ausgeführt und berechnet.

War dieser Artikel hilfreich?

Zurück zu Modelle, Limits & Fehler