Fehlerhilfe für API-Keys

API-Key funktioniert nicht? 401, 402, 403 und 429 beheben

Warum ein KI-API-Key nicht funktioniert: was 401, 402, 403 und 429 bedeuten, welcher Anbieter bei leerem Guthaben welchen Code nutzt und wie du sie behebst.

Aktualisiert
  • Wenn ein KI-API-Key „nicht funktioniert“, verrät die Fehlernummer den Grund: 401 heißt, der Key selbst ist falsch; 402 heißt meist, dass Guthaben oder Credits aufgebraucht sind; 403 heißt, der Key darf das nicht; und 429 heißt zu viele Anfragen oder, bei manchen Anbietern, leeres Guthaben.
  • Die Anbieter sind sich beim Code für leeres Guthaben nicht einig. DeepSeek, OpenRouter, Mistral, Together, Fireworks und die Prepaid-Abrechnung von Gemini nutzen 402; OpenAI, Kimi und Z.ai nutzen 429; Qwen von Alibaba Cloud nutzt 403. Lies die Meldung, nicht nur die Zahl.
  • Guthabenfehler verschwinden nicht durch Abwarten, Ratenlimits meist schon. Die Tabelle unten nennt für jeden Anbieter die offizielle Fehlerseite, geprüft am 18. November 2026.
Oriveo auf dem iPhone: die Anbieterübersicht mit deinen verbundenen Anbietern und den Ausgaben dieses Monats.

Was bedeutet „API-Key funktioniert nicht“ eigentlich?

Ein API-Key ist der geheime Code, den eine App bei jeder Anfrage mitschickt, damit der KI-Anbieter weiß, dass du es bist und welches Konto belastet wird. Geht etwas schief, antwortet der Anbieter mit einem Fehler: einer dreistelligen Zahl, dem sogenannten HTTP-Statuscode, plus einer kurzen Meldung.

Die Zahl sagt dir, welche Art von Problem es ist; die Meldung liefert die Details. Oriveo übersetzt die häufigsten in verständliche Titel wie „Ungültiger API-Schlüssel“ (im Web „Ungültiger API Key“) oder „Anbieter-Kontingent erreicht“; mehr dazu weiter unten auf dieser Seite.

Kurzübersicht: 401, 402, 403, 429 und 5xx

Fang hier an. Such deine Nummer und lies dann den passenden Abschnitt weiter unten. Diese Übersicht folgt den Fehlerseiten von OpenAI, Anthropic und anderen Anbietern (Stand: 18. November 2026).

Kurzübersicht: 401, 402, 403, 429 und 5xx
CodeWas er meist bedeutetHilft Abwarten?Was du tun kannst
401Der Key ist falsch: ein fehlendes Zeichen, ein Leerzeichen zu viel, ein gelöschter Key oder ein Key von einem anderen Anbieter oder aus einer anderen RegionNeinKey erneut kopieren oder neu erstellen; Anbieter und Region prüfen
402Zahlung erforderlich: Prepaid-Guthaben oder Credits sind aufgebraucht, oder es gibt ein AbrechnungsproblemNeinAufladen oder die Zahlungsmethode auf der Abrechnungsseite des Anbieters korrigieren
403Der Key funktioniert, ist aber nicht berechtigt: Land oder Region wird nicht unterstützt, kein Zugriff auf dieses Modell oder ein Verifizierungsschritt steht ausNeinUnterstützte Regionen, Berechtigungen des Keys und eine eventuelle Verifizierung prüfen
404Modellname oder Adresse ist falschNeinEin anderes Modell wählen oder die Adresse prüfen
429Zu viele Anfragen in kurzer Zeit oder, bei manchen Anbietern, leeres Guthaben bzw. ein AusgabenlimitOft, wenn es ein Ratenlimit istWarten und erneut versuchen; nennt die Meldung quota, balance, credit oder ein Ausgabenlimit (spend limit), aufladen oder das Limit erhöhen
500–504, 529Ein Fehler oder eine Überlastung beim AnbieterMeistensSpäter erneut versuchen oder das Modell wechseln

Warum steht da „insufficient balance“ oder „quota“?

Bei den meisten Anbietern funktioniert die API erst mit Prepaid-Guthaben oder einer aktiven Zahlungsmethode, und jeder meldet ein leeres Guthaben auf seine eigene Weise. Ein neuer Key behebt keinen dieser Fälle; Guthaben aufladen schon.

Die Tabelle zeigt, welchen Code jeder der 15 integrierten Anbieter von Oriveo dokumentiert, wenn Guthaben oder Credits aufgebraucht sind. „Nicht angegeben“ heißt, dass die Dokumentation des Anbieters, geprüft am 18. November 2026, für diesen Fall keinen HTTP-Code nennt.

Warum steht da „insufficient balance“ oder „quota“?
AnbieterCode bei leerem GuthabenWas die Meldung sagtOffizielle Seite
OpenAI429credit_balance_exhausted (der Fehlertyp kann weiterhin insufficient_quota lauten)developers.openai.com/api/docs/guides/error-codes
Anthropic (Claude)Nicht angegeben„Your credit balance is too low to access the Anthropic API“; Zahlungsprobleme liefern 402 billing_errorplatform.claude.com/docs/en/api/errors (Codes); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (Meldung)
Google Gemini402 (Prepaid-Abrechnung)payment_required; 403 kann auch einen offenen Betrag im Cloud-Billing-Konto bedeutenaistudio.google.com/docs/api-errors
OpenRouter402Your account or API key has insufficient creditsopenrouter.ai/docs/api-reference/errors
DeepSeek402Insufficient Balanceapi-docs.deepseek.com/quick_start/error_codes
xAI (Grok)Nicht angegebenAnfragen werden abgelehnt, sobald das Prepaid-Guthaben aufgebraucht istdocs.x.ai/console/billing
Mistral AI402Payment requireddocs.mistral.ai/resources/error-glossary
GroqNicht dokumentiertGroq rechnet nach der Nutzung ab; die Fehlerseite nennt keinen Guthabenfehlerconsole.groq.com/docs/errors
Together AI402Payment Requireddocs.together.ai/docs/error-codes
Fireworks AI402Payment Requireddocs.fireworks.ai/guides/inference-error-codes
MiniMaxNicht angegeben (eigener Fehlercode 1008)insufficient balanceplatform.minimax.io/docs/api-reference/errorcode
Z.ai (GLM)429 (Code 1113)Insufficient balance or no resource package. Please recharge.docs.z.ai/api-reference/api-code
Qwen (Alibaba Cloud)403Arrearage oder isv.OUT_OF_SERVICE (Konto mit Zahlungsrückstand)alibabacloud.com/help/en/model-studio/error-code
Kimi (Moonshot AI)429exceeded_current_quota_errorplatform.kimi.ai/docs/api/errors
SiliconFlowNicht dokumentiertKein Guthabenfehler aufgeführtdocs.siliconflow.com/en/faqs/error-code

401: ungültiger API-Key oder Authentifizierung fehlgeschlagen

Ein 401 heißt, dass der Anbieter den Key nicht erkennt. Typische Meldungen sind „Incorrect API key provided“ (OpenAI), „authentication_error“ (Anthropic), „Authentication Fails“ (DeepSeek) und „Invalid API key: this is not an OpenRouter API key“ (OpenRouter).

  • Kopiere den Key erneut von der Website des Anbieters und achte auf fehlende Zeichen oder Leerzeichen am Anfang oder Ende.
  • Prüfe, ob der Key zum gewählten Anbieter gehört. Ein OpenAI-Key funktioniert nicht als OpenRouter-Key und umgekehrt.
  • Kimi, MiniMax und Qwen betreiben getrennte regionale Plattformen, und ein Key von der einen funktioniert nicht auf der anderen. Wähle in Oriveo die passende Region in der Auswahl „Offizieller Endpoint“ (auf dem iPhone „Offizielle Anfrage-URL“).
  • Wurde der Key gelöscht oder widerrufen oder ist er abgelaufen, erstelle einen neuen.

402: Zahlung erforderlich oder Guthaben nicht ausreichend

Bei einem 402 geht es ums Geld: Das Prepaid-Guthaben ist leer, oder die Zahlungsmethode ist fehlgeschlagen. Lade auf oder aktualisiere deine Zahlungsdaten auf der Abrechnungsseite des Anbieters und sende dann erneut. Abwarten hilft nicht.

In Oriveo erscheint das als „Anbieter-Kontingent erreicht“: „Der Anbieter meldet, dass Kontingent oder Guthaben dieses API-Schlüssels aufgebraucht ist. Prüfe deine Abrechnung beim Anbieter oder wechsle das Modell.“

403: Zugriff verweigert (Forbidden)

Ein 403 heißt, dass der Anbieter den Key erkannt hat, die Anfrage aber nicht zulässt. Der Grund hängt vom Anbieter ab:

  • OpenAI liefert „Country, region, or territory not supported“, wenn die API aus einem Land genutzt wird, das OpenAI nicht unterstützt. Jeder Anbieter veröffentlicht seine Liste unterstützter Länder.
  • Gemini liefert 403, wenn ein Projekt im Gratis-Kontingent eine Verifizierung braucht (FREE_TIER_VERIFICATION_REQUIRED), wenn das verknüpfte Cloud-Billing-Konto einen offenen Betrag hat oder wenn Google einen als geleakt gemeldeten Key gesperrt hat.
  • Anthropic liefert permission_error, wenn der Key die Ressource nicht nutzen darf; prüfe die Einstellungen deiner Organisation und deines Workspace.
  • OpenRouter liefert 403, wenn eine Anfrage durch Berechtigungen, Moderation, eine Schutzregel (Guardrail) oder ein Budgetlimit blockiert wird.
  • SiliconFlow verlangt für manche Modelle eine Identitätsprüfung.
  • Qwen nutzt 403 für ein Konto mit Zahlungsrückstand und für AllocationQuota.FreeTierOnly, wenn das Gratis-Kontingent aufgebraucht und die Einstellung „Free Quota Only“ aktiv ist.

429: zu viele Anfragen, Ratenlimit oder Kontingent überschritten

Meistens heißt 429, dass du in kurzer Zeit zu viele Anfragen oder Tokens geschickt hast. Das ist ein Ratenlimit, und es verschwindet, wenn du einige Dutzend Sekunden wartest. Enthält die Antwort eine Retry-After-Zeit, warte so lange.

Mehrere Anbieter nutzen 429 aber auch für leeres Guthaben oder ein Ausgabenlimit, und dann hilft Abwarten nicht: OpenAI (credit_balance_exhausted oder ein selbst gesetztes Ausgabenlimit), Kimi (exceeded_current_quota_error), Z.ai (Code 1113) und Anthropic, wenn eine Organisation ihr monatliches Ausgabenlimit erreicht (enforced_spend_limit_reached); das gilt bis zum nächsten Monat, sofern du keine höhere Stufe beantragst.

Gratis-Kontingente sind enger. Das Gratis-Kontingent von Gemini und die kostenlosen Modelle von OpenRouter haben Limits pro Minute und pro Tag.

In Oriveo erscheint ein Ratenlimit im Web als „Ratenlimit erreicht“ und auf iPhone und Android als „Anbieter-Ratenlimit erreicht“. Nennt die Meldung Kontingent oder Guthaben (quota, credit), zeigt Oriveo stattdessen „Anbieter-Kontingent erreicht“.

Was bedeuten die Fehlermeldungen in Oriveo?

Diese Meldungen kannst du in Oriveo sehen, hier im deutschen Wortlaut der App:

Was bedeuten die Fehlermeldungen in Oriveo?
Was Oriveo anzeigtWas es bedeutetWas du tun kannst
Gespeichert, aber der Schlüssel scheint ungültig zu sein. Du kannst ihn später in den Anbietereinstellungen überprüfen.Oriveo hat den Anbieter gespeichert, aber der Anbieter hat den Key bei der Prüfung abgelehntKey erneut kopieren und in den Einstellungen dieses Anbieters ersetzen
Ungültiger API-Schlüssel (im Web: Ungültiger API Key)Der Anbieter hat 401 oder 403 zurückgegebenKey prüfen oder ersetzen; bei 403 Region und Berechtigungen prüfen
Anbieter-Kontingent erreichtDer Anbieter meldet, dass Guthaben oder Kontingent dieses Keys aufgebraucht ist (402 oder 429 mit Hinweis auf das Kontingent)Beim Anbieter aufladen oder zu einem anderen Modell wechseln
Ratenlimit erreicht (Web) / Anbieter-Ratenlimit erreicht (iPhone, Android)Gerade zu viele Anfragen (429)Kurz warten und erneut versuchen
Kostenloses Kontingent erreicht (auf Android: Free-Kontingent erreicht)Das heutige Kontingent von Oriveo Free ist aufgebraucht; mit deinem eigenen Key hat das nichts zu tunEigenen API-Key hinzufügen oder auf das Zurücksetzen um 00:00 UTC warten
Oriveo-Seite „Anbieter“ mit verbundenen Anbietern wie OpenAI, Z.ai, Groq, Gemini und Anthropic, jeweils mit ihren Ausgaben
Öffne einen Anbieter in dieser Liste, um seinen Key zu prüfen oder zu ersetzen.

Nutzt du einen eigenen Endpunkt, ein Relay oder ein Gateway?

Verbindest du dich über einen benutzerdefinierten Endpunkt, kann der Fehler von diesem Dienst kommen oder vom Anbieter dahinter. Meldet Oriveo „Diese Verbindung konnte ihren Upstream-Anbieter nicht erreichen“, ist möglicherweise das Konto, das der Dienst selbst beim Anbieter hat, ungültig, ohne Guthaben oder gedrosselt. Das liegt nicht an deiner Konfiguration; wechsle zu einer anderen Verbindung oder wende dich an den Betreiber des Dienstes.

Prüfe das, bevor du einen neuen Key erstellst

Ein neuer Key behebt einen 401 und sonst kaum etwas. Geh vorher diese Liste durch:

  • Du hast den richtigen Anbieter gewählt und, bei Kimi, MiniMax, Qwen, SiliconFlow und Z.ai, auch die richtige Region.
  • Du hast den ganzen Key kopiert, ohne Leerzeichen.
  • Auf dem Konto ist Guthaben, oder eine Zahlungsmethode ist aktiv.
  • Der Anbieter unterstützt dein Land bzw. deine Region.
  • Das gewählte Modell ist für dein Konto bzw. deine Stufe verfügbar.

Häufige Fragen zur App

Warum funktioniert mein API-Key nicht?
Schau auf die Fehlernummer. 401 heißt, der Key ist falsch; 402 heißt, Guthaben oder Credits sind aufgebraucht; 403 heißt, die Anfrage ist nicht erlaubt (oft wegen Region oder Berechtigungen); 429 heißt zu viele Anfragen oder, bei manchen Anbietern, leeres Guthaben.
Was bedeutet ein 401-Fehler beim API-Key?
Der Anbieter erkennt den Key nicht. Kopiere ihn ohne Leerzeichen erneut, prüfe, ob er zum gewählten Anbieter und zur gewählten Region gehört, oder erstelle einen neuen Key.
Was ist der Fehler 402 Payment Required?
Dein Prepaid-Guthaben oder deine Credits sind aufgebraucht, oder es gibt ein Zahlungsproblem. DeepSeek, OpenRouter, Mistral, Together, Fireworks und die Prepaid-Abrechnung von Gemini nutzen diesen Code. Lade auf der Abrechnungsseite des Anbieters auf; Abwarten hilft nicht.
Ist ein 429-Fehler ein Ratenlimit oder ein Kontingentproblem?
Beides ist möglich. Meist ist es ein Ratenlimit, das nach kurzer Wartezeit verschwindet. OpenAI, Kimi und Z.ai liefern 429 aber auch bei leerem Guthaben; nennt die Meldung quota, balance oder credit, lade also Guthaben auf, statt zu warten.
Warum meldet mein OpenAI-API-Key insufficient_quota?
Dein OpenAI-API-Konto hat kein Prepaid-Guthaben mehr. OpenAI liefert 429 mit dem Code credit_balance_exhausted, und der Fehlertyp kann weiterhin insufficient_quota lauten. Lade in den Abrechnungseinstellungen von OpenAI Guthaben auf; ein neuer Key hilft nicht.
Warum funktioniert mein neuer API-Key nicht, obwohl ich ihn richtig kopiert habe?
Meist, weil das Konto noch kein Guthaben hat oder keine Abrechnung eingerichtet ist, weil der Key zu einer anderen Region gehört oder weil die API in deinem Land nicht angeboten wird. Prüf das, bevor du noch einen Key erstellst.

Passende Beiträge

Aus dem Blog

Verständliche Fehlermeldungen für jeden Key

Öffne die Web-App oder lade Oriveo für iPhone oder Android herunter, füge Keys von 15 Anbietern hinzu und erfahre klar, warum eine Anfrage fehlschlägt.

Noch keinen API-Key? Starte einfach mit Oriveo Free.