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.
- 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.

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).
| Code | Was er meist bedeutet | Hilft Abwarten? | Was du tun kannst |
|---|---|---|---|
| 401 | Der 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 Region | Nein | Key erneut kopieren oder neu erstellen; Anbieter und Region prüfen |
| 402 | Zahlung erforderlich: Prepaid-Guthaben oder Credits sind aufgebraucht, oder es gibt ein Abrechnungsproblem | Nein | Aufladen oder die Zahlungsmethode auf der Abrechnungsseite des Anbieters korrigieren |
| 403 | Der Key funktioniert, ist aber nicht berechtigt: Land oder Region wird nicht unterstützt, kein Zugriff auf dieses Modell oder ein Verifizierungsschritt steht aus | Nein | Unterstützte Regionen, Berechtigungen des Keys und eine eventuelle Verifizierung prüfen |
| 404 | Modellname oder Adresse ist falsch | Nein | Ein anderes Modell wählen oder die Adresse prüfen |
| 429 | Zu viele Anfragen in kurzer Zeit oder, bei manchen Anbietern, leeres Guthaben bzw. ein Ausgabenlimit | Oft, wenn es ein Ratenlimit ist | Warten und erneut versuchen; nennt die Meldung quota, balance, credit oder ein Ausgabenlimit (spend limit), aufladen oder das Limit erhöhen |
| 500–504, 529 | Ein Fehler oder eine Überlastung beim Anbieter | Meistens | Spä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.
| Anbieter | Code bei leerem Guthaben | Was die Meldung sagt | Offizielle Seite |
|---|---|---|---|
| OpenAI | 429 | credit_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_error | platform.claude.com/docs/en/api/errors (Codes); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (Meldung) |
| Google Gemini | 402 (Prepaid-Abrechnung) | payment_required; 403 kann auch einen offenen Betrag im Cloud-Billing-Konto bedeuten | aistudio.google.com/docs/api-errors |
| OpenRouter | 402 | Your account or API key has insufficient credits | openrouter.ai/docs/api-reference/errors |
| DeepSeek | 402 | Insufficient Balance | api-docs.deepseek.com/quick_start/error_codes |
| xAI (Grok) | Nicht angegeben | Anfragen werden abgelehnt, sobald das Prepaid-Guthaben aufgebraucht ist | docs.x.ai/console/billing |
| Mistral AI | 402 | Payment required | docs.mistral.ai/resources/error-glossary |
| Groq | Nicht dokumentiert | Groq rechnet nach der Nutzung ab; die Fehlerseite nennt keinen Guthabenfehler | console.groq.com/docs/errors |
| Together AI | 402 | Payment Required | docs.together.ai/docs/error-codes |
| Fireworks AI | 402 | Payment Required | docs.fireworks.ai/guides/inference-error-codes |
| MiniMax | Nicht angegeben (eigener Fehlercode 1008) | insufficient balance | platform.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) | 403 | Arrearage oder isv.OUT_OF_SERVICE (Konto mit Zahlungsrückstand) | alibabacloud.com/help/en/model-studio/error-code |
| Kimi (Moonshot AI) | 429 | exceeded_current_quota_error | platform.kimi.ai/docs/api/errors |
| SiliconFlow | Nicht dokumentiert | Kein Guthabenfehler aufgeführt | docs.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 Oriveo anzeigt | Was es bedeutet | Was 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 abgelehnt | Key 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ückgegeben | Key prüfen oder ersetzen; bei 403 Region und Berechtigungen prüfen |
| Anbieter-Kontingent erreicht | Der 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 tun | Eigenen API-Key hinzufügen oder auf das Zurücksetzen um 00:00 UTC warten |

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?
Was bedeutet ein 401-Fehler beim API-Key?
Was ist der Fehler 402 Payment Required?
Ist ein 429-Fehler ein Ratenlimit oder ein Kontingentproblem?
Warum meldet mein OpenAI-API-Key insufficient_quota?
Warum funktioniert mein neuer API-Key nicht, obwohl ich ihn richtig kopiert habe?
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.