NL ▾
API-sleutel ophalen

kimiapikey.comGids

Kimi API-sleutel werkt niet: oorzaken, oplossingen, back-up

Als je foutmelding 'Kimi API-sleutel werkt niet' als 401, 404 of 429 verschijnt, is de oorzaak bijna altijd een van vijf dingen: de verkeerde basis-URL, een niet-overeenkomende sleutel, geen saldo, een limiet voor verzoeken, of een modelnaam die het endpoint niet kent. Werk ze in deze volgorde af.

Bijgewerkt

Een sleutel in een slot terwijl een groen lichtpad leidt naar een tweede open slot, symboliseert een back-up API-endpoint
Isometrische illustratie van een code-editor die via een gloeiende kabel is verbonden met een API-server

Belangrijkste punten

  • Een sleutel werkt alleen bij de provider die hem heeft uitgegeven, dus basis-URL en sleutel moeten van hetzelfde dashboard komen.
  • 401 betekent dat de sleutel is afgewezen, 404 betekent meestal een verkeerd pad, 429 betekent dat je een limiet hebt bereikt of de service druk is.
  • Log de statuscode en de responsbody voordat je iets anders aanpast.
  • Houd een tweede OpenAI-compatible endpoint geconfigureerd zodat één storing je app niet stopt.

Lees eerst de status code

Voordat je iets regeneert, kijk je wat de server precies zei. De meeste clients in OpenAI-stijl verbergen de body achter een generieke uitzondering. Log zowel de status als de tekst.

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

De eerste regel van het antwoord vertelt je waar je moet kijken:

CodeGewone betekenisBegin met
401Sleutel afgewezenSleutelkopie, sleutel en basis-URL van verschillende providers
404Pad of model niet gevondenOntbreekt /v1, verdubbeld pad, verkeerde model-ID
400Verzoeklichaam ongeldigParameternamen, berichtformaat, lichaamsgrootte
429Limiet bereikt of service bezetVerzoekfrequentie, gelijktijdige aanroepen, retry-timing
5xxServerkant probleemProbeer opnieuw met backoff, en schakel dan over op een uitwijkoptie

Als je helemaal geen HTTP-antwoord krijgt (een time-out of een DNS-fout), is het probleem het netwerk of de hostname die je hebt ingetypt, niet de sleutel.

Basis-URL en sleutel moeten bij elkaar passen

Dit is de meest voorkomende reden dat een nieuwe sleutel faalt. Sleutels worden per provider uitgegeven. Een sleutel van één dashboard is gewoon onbekend bij de servers van een andere provider, dus hij geeft 401 terug, hoewel de sleutel waar hij vandaan komt perfect geldig is.

Controleer deze punten:

  • De sleutel en de basis-URL komen van dezelfde accountpagina. Als je de sleutel van de ene provider hebt gekopieerd en een oude basis-URL in je config hebt gelaten, gaat het verzoek naar de verkeerde plek.
  • Omgevingsvariabelen overschrijven je code niet. De OpenAI SDK leest OPENAI_API_KEY en OPENAI_BASE_URL als je ze niet expliciet doorgeeft, dus een verouderde shell-variabele kan overschrijven wat je in het bestand hebt geschreven.
  • Er staat geen witruimte of regeleinde aan het einde van de sleutel. Een regeleinde aan het einde bij kopieer-plak is een klassieke oorzaak van 401.
  • De header is exact Authorization: Bearer <key>. Sommige tools verwachten de sleutel in een andere header en hebben aan de OpenAI-compatible modus ingeschakeld.

Editors en chat-frontend voegen nog een valstrik toe. Veel van hen houden een apart veld aan voor de "OpenAI base URL" en een aparte toggle die het activeert. Als de toggle uit staat, blijft de app stil de standaard host aanroepen met je nieuwe sleutel, en krijg je een 401 die lijkt op een slechte sleutel. Sla de instellingen op, start de app opnieuw op als deze ze cacheert, en stuur één korte testbericht voordat je iets ingewikkelds test.

De base URL moet eindigen bij /v1, niet bij de host en niet bij /v1/chat/completions. De SDK voegt de rest toe. Een URL die al het volledige pad bevat, eindigt als een verdubbeld pad en een 404.

Regionale toegang, proxies en bedrijfsnetwerken

Soms is de sleutel prima en bereikt het verzoek de juiste server niet. De beschikbaarheid van de provider kan afhangen van waar je vandaan verbindt, en een VPN, een bedrijfsproxy of een firewall-regel kan verkeer blokkeren of herschrijven. Kijk naar de eigen documentatie of statuspagina van de provider voor hun beschikbare regio's, en ga er niet van uit dat de regels hetzelfde zijn als voor een andere dienst.

Een snelle isolatietest: voer hetzelfde curl command uit vanaf een ander netwerk, zoals een telefoonhotspot. Als het daar werkt, is de sleutel goed en is je netwerk de oorzaak. Als de proxy HTTPS_PROXY instelt, controleer dan of je HTTP library dat echt respecteert; sommige tools negeren het en falen met een verbindingsfout.

Saldo, quota en hoe een rate limit eruit ziet

Een sleutel kan geldig zijn en toch verzoeken weigeren omdat de account geen tegoed meer heeft of een limiet is opgebruikt. Controleer het dashboard voordat je code debugt. Als je nog nooit hebt opgewaardeerd, onthoud dan dat gratis tegoed meestal klein en kortstondig is.

Een 429 is een ander verhaal. Het betekent dat de server je vertraagt, niet dat de sleutel slecht is. Op het endpoint zoals beschreven op deze site, staat een volledige sleutel 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe, en een trial sleutel staat 2 gelijktijdige en 60 per minuut toe. Wanneer je ze overschrijdt, retourneert de API HTTP 429 met de error code rate_limited (te veel per minuut) of concurrency (te veel in één keer). Tijdelijke overbelasting retourneert ook 429, met een Retry-After: 5 header.

Twee gewoonten lossen de meeste van deze op. Eer Retry-After als het aanwezig is, en beperk je parallelle workers bij het concurrency limit. Een gestreamd verzoek houdt zijn slot vast tot de stream eindigt, dus een gestagneerde stream telt langer tegen je aan dan je verwacht.

Modelnaam, parameters en bodygrootte

Een 404 of een 400 met een geldige sleutel wijst meestal naar het request zelf. Drie dingen om te controleren:

  1. Model ID. Elke provider heeft zijn eigen model names. Vraag het endpoint wat het serveert met GET /v1/models en kopieer de ID uit het antwoord. Op deze site is de ID uncensored.
  2. Parameters. Namen zoals max_tokens, temperature en response_format zijn standaard, maar een provider accepteert misschien maar een subset. Verwijder optionele velden totdat het request slaagt, en voeg ze dan één voor één weer toe.
  3. Grootte. Zeer grote prompts kunnen falen op body limits voordat het model ze ziet. Hier is de maximum body 8 MB en het contextvenster 100.000 tokens voor prompt en completion samen.

Streaming is nog een plek waar een werkende sleutel kapot lijkt. Als een request slaagt zonder stream: true en faalt met het, is de oorzaak vaak een proxy die server-sent events buffer of knipt, niet het endpoint. Zet streaming uit om te bevestigen, en kijk dan naar de proxy settings.

Als je alleen de model naam hebt gewijzigd en de aanroep kapot ging, zet dan de oude naam terug om te bevestigen dat de rest van je setup in orde is.

Houd een fallback endpoint klaar

Zelfs een gezonde provider heeft slechte uren. Als je product afhankelijk is van één sleutel, wordt een enkele fout jouw storing. Omdat het OpenAI-verzoekformaat gedeeld is, kun je een tweede endpoint geconfigureerd houden en schakelen met een paar regels.

Het endpoint op deze site is OpenAI-compatible, dus het past als een tweede provider. Het is een onafhankelijke gehoste open-weight model, niet Moonshot's officiële service, en het zal anders antwoorden dan een Kimi model, dus test je prompts voordat je erop vertrouwt. Hier is een kleine wrapper die eerst de primaire probeert en bij fouten terugvalt:

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."}]))

Prijzen is pay as you go: $0,15 per 1M input tokens en $0,50 per 1M output tokens van prepaid tegoed dat nooit vervalt. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus een fallback die zelden draait kost bijna niets om te onderhouden. Top-ups beginnen bij $20; zie prijzen voor de bonus tiers.

Test de fallback in twee minuten

Nieuwe gebruikers kunnen na aanmelding met één klik $0,50 proefcredit claimen op de API-sleutelpagina. Het vereist geen kaart en is 7 dagen geldig, wat genoeg is om je echte prompts een keer via het endpoint te runnen. Voer daarna de smoke test hieronder uit.

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"}]}'

Controleer de X-Balance-USD response header om je resterende credit te zien. De volledige request reference staat in de documentatie. Als je dit in een editor wilt integreren, toont de bestaande walkthrough over een API-sleutel in Kimi-stijl gebruiken in Cursor waar het base URL veld zit, en de overzicht van de Kimi API-sleutel legt uit hoe dit endpoint relateert aan het model dat je gebruikte.

Veelgestelde vragen

Is het model hetzelfde als het officiële Kimi van Moonshot?
Nee, we hosten een open-weight model dat is afgestemd om ongecensureerd te zijn. Het is geen GPT, Claude, Gemini, Grok, DeepSeek of het model van een andere leverancier. Het is een apart model dat op onze eigen servers draait.

Wordt er met mijn data getraind?
Nee. Je prompts en completions worden niet gebruikt voor training. Wij hechten waarde aan privacy en transparantie, dus jouw data blijft van jou.

Wat zijn de rate limits?
Je bent beperkt tot 300 verzoeken per minuut per sleutel. De maximale grootte van de request body is 8 MB. Deze limieten zijn ontworpen om een stabiele prestatie te garanderen voor alle gebruikers.

Wat is het contentbeleid?
Het model is ongecensureerd voor volwassen, controversiële en creatieve onderwerpen. We blokkeren wel seksuele inhoud met minderjarigen. Dit is een harde limiet die altijd geldt, ongeacht je abonnementsniveau.

Vragen en antwoorden

Waarom geeft mijn nieuwe sleutel direct een 401?

De meest voorkomende oorzaken zijn een sleutel die naar de base URL van een andere provider wordt gestuurd, een losse spatie of newline in de gekopieerde sleutel, of een omgevingsvariabele die je code overschrijft. Test met curl om je SDK uit te sluiten.

Is een 429 hetzelfde als een ongeldige sleutel?

Nee. Een 429 betekent dat je een rate limit, een concurrency limit of een tijdelijke overbelasting hebt bereikt. De sleutel is geldig. Wacht op de Retry-After waarde en verlaag je gelijktijdige verzoeken.

Kost een mislukt verzoek hier geld?

Nee. Mislukte of geweigerde verzoeken worden op deze endpoint niet in rekening gebracht, dus het opnieuw proberen van een gebroken aanroep verbruikt niet je tegoed.

Kan ik deze endpoint als drop-in voor een Kimi-model gebruiken?

Het gebruikt hetzelfde OpenAI-verzoekformaat, dus de code-aanpassing is een base URL, een sleutel en de model ID uncensored. Het onderliggende model verschilt, dus de antwoorden zullen niet overeenkomen; test je prompts eerst.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele configuratie.

API-sleutel aanvragenLees de documentatie