DE ▾
API-Schlüssel erhalten

kimiapikey.comAnleitung

Kimi API-Schlüssel funktioniert nicht: Ursachen, Lösungen, Fallback

Wenn dein Fehler „kimi api key not working“ als 401, 404 oder 429 erscheint, liegt die Ursache fast immer an einem von fünf Dingen: die falsche Basis-URL, ein nicht passender Schlüssel, kein Guthaben, ein Ratenlimit oder ein Modellname, den der Endpunkt nicht kennt. Gehe sie in dieser Reihenfolge durch.

Aktualisiert

Ein Schlüssel, der in ein Schloss passt, während ein grüner Lichtweg zu einem zweiten offenen Schloss führt, symbolisiert einen Fallback-API-Endpunkt
Isometrische Illustration eines Code-Editors, der über ein leuchtendes Kabel mit einem API-Server verbunden ist

Wichtige Punkte

  • Ein Schlüssel funktioniert nur beim Anbieter, der ihn ausgestellt hat, also müssen Basis-URL und Schlüssel aus demselben Dashboard stammen.
  • 401 bedeutet, dass der Schlüssel abgelehnt wurde, 404 bedeutet meist einen falschen Pfad, 429 bedeutet, dass du ein Limit erreicht hast oder der Dienst ausgelastet ist.
  • Gib den Statuscode und den Antworttext aus, bevor du etwas anderes änderst.
  • Halte einen zweiten OpenAI-kompatiblen Endpunkt konfiguriert, damit ein Ausfall deine App nicht stoppt.

Lies zuerst den Statuscode

Bevor du etwas neu generierst, schau dir an, was der Server tatsächlich gesagt hat. Die meisten OpenAI-kompatiblen Clients verstecken den Text hinter einer generischen Ausnahme. Gib sowohl den Status als auch den Text aus.

curl -i https://api.kimiapikey.com/v1/models \
  -H "Authorization: Bearer $YOUR_KEY"

Die erste Zeile der Antwort sagt dir, wo du suchen musst:

CodeÜbliche BedeutungStarte mit
401Schlüssel abgelehntSchlüsselkopie, Schlüssel und Basis-URL von verschiedenen Anbietern
404Pfad oder Modell nicht gefundenFehlender /v1, doppelter Pfad, falsche Modell-ID
400Anfragekörper ungültigParameter, Nachrichtenformat und Body-Größe
429Limit erreicht oder Dienst ausgelastetAnfrage-Rate, parallele Aufrufe, Retry-Zeitpunkt
5xxServerseitiges ProblemWiederhole mit Backoff, wechsle dann zum Fallback

Wenn du gar keine HTTP-Antwort erhältst (ein Timeout oder ein DNS-Fehler), ist das Problem das Netzwerk oder der eingegebene Hostname, nicht der Schlüssel.

Base URL und Schlüssel müssen zusammengehören

Dies ist die häufigste Ursache, warum ein neuer Schlüssel fehlschlägt. Schlüssel werden pro Anbieter ausgestellt. Ein Schlüssel aus einem Dashboard ist den Servern eines anderen Anbieters einfach unbekannt, also gibt er 401 zurück, obwohl der Schlüssel dort, woher er stammt, völlig gültig ist.

Prüfe diese Punkte:

  • Der Schlüssel und die Base URL stammen von derselben Kontoseite. Wenn du den Schlüssel von einem Anbieter kopiert hast, aber eine alte Base URL in deiner Konfiguration belassen hast, geht die Anfrage an den falschen Ort.
  • Umgebungsvariablen überschatten deinen Code nicht. Das OpenAI SDK liest OPENAI_API_KEY und OPENAI_BASE_URL, wenn du sie nicht explizit übergibst, sodass eine veraltete Shell-Variable das in der Datei Geschriebene überschreiben kann.
  • Es gibt kein Leerzeichen oder keinen Zeilenumbruch am Ende des Schlüssels. Ein nachgestellter Zeilenumbruch beim Kopieren und Einfügen ist eine klassische Ursache für 401.
  • Der Header ist genau Authorization: Bearer <key>. Einige Tools erwarten den Schlüssel in einem anderen Header und benötigen den OpenAI-kompatiblen Modus.

Editoren und Chat-Frontends fügen eine weitere Falle hinzu. Viele von ihnen behalten ein separates Feld für die „OpenAI Base URL“ und einen separaten Schalter, der ihn aktiviert. Wenn der Schalter aus ist, ruft die App weiterhin still den Standard-Host mit deinem neuen Schlüssel auf, und du erhältst einen 401, der wie ein falscher Schlüssel aussieht. Speichere die Einstellungen, starte die App neu, wenn sie sie zwischenspeichert, und sende eine kurze Testnachricht, bevor du etwas Komplizierteres testest.

Die Base URL sollte bei /v1 enden, nicht beim Host und nicht bei /v1/chat/completions. Der SDK hängt den Rest an. Eine URL, die bereits den vollständigen Pfad enthält, endet als doppelter Pfad und 404.

Regionaler Zugriff, Proxies und Unternehmensnetzwerke

Manchmal ist der Schlüssel in Ordnung und die Anfrage erreicht den richtigen Server nicht. Die Verfügbarkeit des Anbieters kann davon abhängen, von wo du dich verbindest, und ein VPN, ein Unternehmensproxy oder eine Firewall-Regel kann den Verkehr blockieren oder umschreiben. Schau in die Dokumentation oder Statusseite des Anbieters für ihre unterstützten Regionen und gehe nicht davon aus, dass die Regeln für einen anderen Dienst gleich sind.

Ein schneller Isolierungstest: Führe denselben curl-Befehl von einem anderen Netzwerk aus, z. B. einem Handy-Hotspot. Wenn es dort funktioniert, ist der Schlüssel gut und dein Netzwerk ist die Ursache. Wenn der Proxy HTTPS_PROXY setzt, prüfe, ob deine HTTP-Bibliothek dies tatsächlich respektiert; einige Tools ignorieren es und schlagen mit einem Verbindungsfehler fehl.

Guthaben, Kontingent und wie ein Ratenlimit aussieht

Ein Schlüssel kann gültig sein und dennoch Anfragen verweigern, weil das Konto kein Guthaben mehr hat oder ein Kontingent aufgebraucht ist. Prüfe das Dashboard, bevor du Code debuggst. Wenn du noch nie aufgeladen hast, erinnere dich daran, dass kostenlose Kontingente normalerweise klein und kurzlebig sind.

Eine 429 ist eine andere Geschichte. Das bedeutet, dass der Server dich ausbremst, nicht dass der Schlüssel defekt ist. Auf dem auf dieser Seite beschriebenen Endpunkt erlaubt ein vollständiger Schlüssel 8 parallele Anfragen und 300 Anfragen pro Minute, ein Test-Schlüssel erlaubt 2 parallele und 60 pro Minute. Wenn du diese Werte überschreitet, gibt die API HTTP 429 mit dem Fehlercode rate_limited (zu viele pro Minute) oder concurrency (zu viele gleichzeitig) zurück. Bei einer temporären Überlastung wird ebenfalls 429 zurückgegeben, mit dem Header Retry-After: 5.

Zwei Gewohnheiten beheben die meisten dieser Probleme. Beachte Retry-After, wenn es vorhanden ist, und beschränke deine parallelen Worker auf das Concurrency-Limit. Eine gestreamte Anfrage belegt ihren Slot bis zum Ende des Streams, sodass ein gestallter Stream länger gegen dich zählt, als du erwartest.

Modellname, Parameter und Anfragekörper-Größe

Ein 404 oder ein 400 mit einem gültigen Schlüssel deutet normalerweise auf die Anfrage selbst hin. Drei Dinge, die du prüfen solltest:

  1. Modell-ID. Jeder Anbieter hat seine eigenen Modellnamen. Frage den Endpunkt, was er mit GET /v1/models ausliefert, und kopiere die ID aus der Antwort. Auf dieser Website ist die ID uncensored.
  2. Parameter. Namen wie max_tokens, temperature und response_format sind Standard, aber ein Anbieter akzeptiert möglicherweise nur eine Teilmenge. Entferne optionale Felder, bis die Anfrage durchgeht, und füge sie dann einzeln wieder hinzu.
  3. Größe. Sehr große Prompts können an den Anfragekörper-Limits fehlschlagen, bevor das Modell sie sieht. Hier beträgt der maximale Anfragekörper 8 MB und das Kontextfenster 100.000 Token für Prompt und Antwort zusammen.

Streaming ist ein weiterer Ort, an dem ein funktionierender Schlüssel kaputt aussieht. Wenn eine Anfrage ohne stream: true erfolgreich ist und mit ihr fehlschlägt, ist die Ursache oft ein Proxy, der Server-Sent-Events puffert oder abschneidet, nicht der Endpunkt. Schalte Streaming aus, um dies zu bestätigen, und prüfe dann die Proxy-Einstellungen.

Wenn du nur den Modellnamen geändert hast und der Aufruf fehlschlug, setze den alten Namen zurück, um zu bestätigen, dass der Rest deiner Einrichtung in Ordnung ist.

Halte einen Fallback-Endpunkt bereit

Selbst ein gesunder Anbieter hat schlechte Stunden. Wenn dein Produkt von einem Schlüssel abhängt, wird ein einzelner Ausfall zu deinem Ausfall. Da das OpenAI-Anfrageformat gemeinsam genutzt wird, kannst du einen zweiten Endpunkt konfiguriert halten und mit ein paar Zeilen wechseln.

Der Endpunkt auf dieser Website ist OpenAI-kompatibel, also fügt er sich als zweiter Anbieter ein. Es ist ein unabhängiges gehostetes Open-Weight-Modell, nicht der offizielle Dienst von Moonshot, und es wird anders antworten als ein Kimi-Modell, also teste deine Prompts, bevor du dich darauf verlässt. Hier ist ein kleiner Wrapper, der zuerst den Primärversuch unternimmt und bei Fehlern zurückfällt:

import os
from openai import OpenAI

primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
                 api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
                  api_key=os.environ["FALLBACK_KEY"])

def ask(messages):
    try:
        r = primary.chat.completions.create(
            model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
    except Exception as e:
        print("primary failed:", e)
        r = fallback.chat.completions.create(
            model="uncensored", messages=messages, timeout=60)
    return r.choices[0].message.content

print(ask([{"role": "user", "content": "Say hi in five words."}]))

Preise: Pay as you go. $0,15 pro 1M Input-Token, $0,50 pro 1M Output-Token vom Prepaid-Guthaben, das verfällt nie. Fehlgeschlagene Anfragen werden nicht berechnet. Top-ups ab $20. Siehe Preise für Bonusstufen.

Teste den Fallback in zwei Minuten

Neue Nutzer können mit einem Klick auf der API-Schlüssel-Seite nach der Anmeldung $0,50 Testguthaben beanspruchen. Es benötigt keine Karte und ist 7 Tage lang gültig, was ausreicht, um deine echten Prompts einmal durch den Endpunkt zu schicken. Führe dann den Smoke-Test unten aus.

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $FALLBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Überprüfe den X-Balance-USD-Antwortheader, um dein verbliebenes Guthaben zu sehen. Die vollständige Referenz zur Anfrage findest du in der Dokumentation. Wenn du dies in einen Editor einbindest, zeigt der bestehende Leitfaden zu Verwendung eines Kimi-API-Schlüssels in Cursor, wo das Feld für die Basis-URL liegt, und die Übersicht zum Kimi-API-Schlüssel erklärt, wie dieser Endpunkt mit dem Modell zusammenhängt, das du verwendet hast.

Häufig gestellte Fragen

Ist das Modell dasselbe wie das offizielle Kimi von Moonshot?
Nein, wir hosten ein Open-Weight-Modell, das auf unzensiert optimiert ist. Es ist kein GPT, Claude, Gemini, Grok, DeepSeek oder ein anderes Modell eines Anbieters. Es ist ein eigenständiges Modell, das auf unseren eigenen Servern läuft.

Trainierst du mit meinen Daten?
Nein. Deine Prompts und Completions werden nicht zum Training verwendet. Wir schätzen Privatsphäre und Transparenz, daher bleiben deine Daten bei dir.

Was sind die Ratenlimits?
Du bist auf 300 Anfragen pro Minute pro Schlüssel begrenzt. Die maximale Größe des Anfragekörpers beträgt 8 MB. Diese Limits gewährleisten eine stabile Leistung für alle Nutzer.

Was ist die Inhaltsrichtlinie?
Das Modell ist unzensiert bezüglich erwachsener, kontroverser und kreativer Themen. Allerdings blockieren wir sexuelle Inhalte, die Minderjährige betreffen. Dies ist eine harte Grenze, die immer gilt, unabhängig von deinem Abonnementlevel.

Fragen und Antworten

Warum erhalte ich sofort 401?

Die häufigsten Gründe sind ein Schlüssel, der an die Basis-URL eines anderen Anbieters gesendet wird, ein fehlgeschlagenes Leerzeichen oder ein Zeilenumbruch im kopierten Schlüssel oder eine Umgebungsvariable, die deinen Code überschreibt. Teste mit curl, um deinen SDK auszuschließen.

Ist ein 429 dasselbe wie ein falscher Schlüssel?

Nein. Ein 429 bedeutet, dass du ein Ratenlimit, ein Concurrency-Limit oder eine temporäre Überlastung erreicht hast. Der Schlüssel ist gültig. Warte den Retry-After-Wert ab und reduziere deine parallelen Anfragen.

Kostet es hier Geld für fehlgeschlagene Anfragen?

Nein. Fehlgeschlagene oder abgelehnte Anfragen werden auf diesem Endpunkt nicht berechnet, sodass das Wiederholen eines fehlgeschlagenen Aufrufs dein Guthaben nicht erschöpft.

Kann ich diesen Endpunkt als sofort einsetzbare Alternative für ein Kimi-Modell verwenden?

Es verwendet dasselbe OpenAI-Anfrageformat, daher besteht die Codeänderung aus einer Base URL, einem Schlüssel und der Modell-ID uncensored. Das zugrunde liegende Modell ist anders, daher werden die Antworten nicht übereinstimmen; teste zuerst deine Prompts.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhaltenDokumentation lesen