Start → Hilfe

Ein Modell, das gestern lief, scheitert jetzt für alle in derselben Schlüsselgruppe

Gateways routen nach Gruppen: Ein Schlüssel gehört zu einer Gruppe, eine Gruppe zeigt auf ein oder mehrere Upstream-Konten. Hat die Gruppe nur ein Konto und liefert dieses das Modell nicht mehr – Guthaben abgelaufen, Schlüssel widerrufen, Modellliste passt nicht mehr –, verliert jeder Schlüssel der Gruppe das Modell auf einen Schlag.

Was Sie sehen

Warum das passiert

Die Fehlermeldung zeigt auf das Modell, also prüfen Leute Schreibweise und Verfügbarkeit. Gemeldet wird aber eigentlich „kein Konto in Ihrer Gruppe kann das bedienen“, und die Lösung liegt auf der Kontoseite.

Gruppen mit nur einem Konto haben per Konstruktion keine Redundanz. Mit zwei oder mehr Konten schaltet der Router um und niemand merkt etwas; mit einem ist ein einziges Upstream-Problem ein Totalausfall für diese Gruppe.

Eine subtilere Variante: Ein Konto bietet ein Modell an, das es gar nicht liefern kann. Jede dorthin geroutete Anfrage scheitert, und je nach Gesundheitslogik des Routers können die wiederholten Fehler die ganze Gruppe aus der Rotation nehmen – sodass auch Modelle, die vorher liefen, scheitern. Genau das haben wir erlebt: Ein einziger falsch deklarierter Modellname in der Liste eines Kontos hat den Verkehr einer ganzen Gruppe lahmgelegt.

Prüfen, ob es daran liegt

Fragen Sie das Gateway, was Ihr Schlüssel tatsächlich erreicht, statt es anzunehmen:

curl -s 'YOUR_BASE_URL/models' \
  -H 'Authorization: Bearer YOUR_KEY' \
  | python3 -c 'import sys,json; d=json.load(sys.stdin); print(len(d["data"]), "models"); [print(" ", m["id"]) for m in d["data"]]'

Fehlt das Modell in dieser Liste, kann die Gruppe des Schlüssels es nicht bedienen – keine Korrektur an der Anfrage hilft. Ist es da und die Aufrufe scheitern trotzdem, ist das Upstream-Konto hinter der Gruppe kaputt.

So beheben Sie es

  1. Zuerst /models mit dem scheiternden Schlüssel abfragenDas beantwortet mit einer Anfrage, ob es ein Routing- oder ein Anfrageproblem ist, und kostet nichts.
  2. Den Anbieter fragen, zu welcher Gruppe der Schlüssel gehörtZwei gleich aussehende Schlüssel können in verschiedenen Gruppen mit verschiedenen Upstream-Konten liegen. Die Gruppe zu kennen macht aus „manchmal klappt es“ eine reproduzierbare Regel.
  3. Für alles Wichtige einen zweiten Schlüssel in einer anderen Gruppe bereithaltenDas ist die billigste verfügbare Redundanz: Hat eine Gruppe ein Upstream-Problem, ist der Schlüsselwechsel eine einzeilige Änderung statt eines Ausfalls.
  4. Sich nicht darauf verlassen, dass ein Modell in einer öffentlichen Liste stehtEin Modell auf einer Preisseite kann für Ihre Gruppe trotzdem nicht verfügbar sein. Maßgeblich ist, was /models für Ihren Schlüssel zurückgibt.
Bei APICLAN gehört jeder Schlüssel zu genau einer Gruppe, und /models zeigt immer, was dieser Schlüssel wirklich aufrufen kann. Welche Modelle jede Gruppe führt, steht auf der Preisseite.

Verwandte Themen

Unexpected token '<' beim Aufruf einer OpenAI-kompatiblen API401 invalid API key – wenn der Schlüssel richtig aussieht und trotzdem scheitert

Zuletzt geprüft am 2026-10-01. Geschrieben aus Problemen, die auf einem laufenden OpenAI-kompatiblen Gateway diagnostiziert wurden – nicht von anderen Seiten zusammengetragen.