kimiapikey.comDocs
Kimi API: eerste verzoek in vijf minuten
Ontvang je eerste respons binnen vijf minuten via de standaard OpenAI-compatible interface. Deze gids behandelt setup, authenticatie en basisgebruik voor het ongecensureerde model.
Vereisten
Om te beginnen heb je een API-sleutel van kimiapikey.com nodig. Meld je aan met alleen een e-mailadres en wachtwoord; er is geen creditcard nodig voor de proefversie. Je hebt ook een ondersteunde taalomgeving nodig met een officiële of compatibele SDK geïnstalleerd. Onze API volgt het OpenAI chat-completions-formaat, dus bestaande code voor GPT-3.5/4 werkt vaak met minimale aanpassingen. Zorg dat je SDK-versie recent genoeg is om de base_url parameter te ondersteunen.
Base URL en authenticatie
Onze API is beschikbaar op https://api.kimiapikey.com/v1. Authenticatie wordt afgehandeld via de standaard Authorization header. Geef je sleutel door als Bearer token. Dit werkt met elke client die OpenAI-compatible endpoints accepteert. Als je een proxy of aangepaste client gebruikt, zorg er dan voor dat deze de Authorization header correct doorstuurt. De model-ID die je zult opvragen is uncensored.
Eerste verzoek
Stuur een eenvoudige chat completion om je setup te verifiëren. Gebruik het curl commando hieronder en vervang YOUR_API_KEY door je daadwerkelijke sleutel. Dit verzoek stuurt een korte prompt naar het uncensored model. Als het succesvol is, ontvang je een JSON-response met het antwoord van het model. Controleer de choices array voor de gegenereerde tekst. Als je een 401-fout krijgt, is je sleutel ongeldig of verlopen.
Python SDK
Gebruik de officiële OpenAI Python-bibliotheek voor de eenvoudigste integratie. Stel de base_url in op onze endpoint en lever je sleutel op. Dit voorbeeld toont een basisaanroep voor tekstgeneratie. Je kunt de parameter model indien nodig aanpassen, hoewel uncensored de standaard is. Deze aanpak houdt je code draagbaar voor verschillende OpenAI-compatibele diensten.
Node SDK
Voor JavaScript/TypeScript-projecten gebruik je het openai npm-pakket. Configureer de client met onze basis-URL en je API-sleutel. Hiermee kun je verzoeken rechtstreeks vanuit je Node-omgeving uitvoeren. De syntaxis lijkt op de Python SDK, wat consistentie garandeert als je van taal wisselt. Vergeet niet asynchrone responsen correct af te handelen met behulp van await.
Streaming responses
Schakel voor realtime uitvoer streaming in je SDK in. Dit stuurt tekstfragmenten terwijl ze worden gegenereerd, wat de waargenomen latentie vermindert. Gebruik de vlag stream in je verzoek. De SDK levert gedeeltelijke responsen, waardoor je de UI geleidelijk kunt bijwerken. Dit is ideaal voor chatinterfaces of het genereren van lange teksten waarbij directe feedback waardevol is.
Limieten en fouten
Elke sleutel is beperkt tot 300 verzoeken per minuut. Als je dit overschrijdt, ontvang je een 429-fout. Je verzoeklichaam mag niet groter zijn dan 8 MB. Een contextvenster van 100.000 tokens geldt voor de som van prompt en voltooiing. Veelvoorkomende fouten zijn 401 (ongeldige sleutel) en 402 (onvoldoende tegoed). Laad op via het dashboard om de API te blijven gebruiken. Credits vervallen nooit en er zijn geen maandelijkse kosten.
cURL
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Streaming
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Vragen en antwoorden
Ondersteunt de API function calling?
Ja, de endpoint ondersteunt tool/function calling in het standaard OpenAI-formaat. Je kunt tools definiëren in je verzoek en het model retourneert gestructureerde argumenten.
Wat gebeurt er als ik de rate limit overschrijd?
Je ontvangt een 429 Too Many Requests-fout. Wacht kort en probeer het opnieuw, of upgrade je prepaid tegoed voor een hogere doorvoercapaciteit.
Wordt het model getraind op mijn data?
Nee. Prompts die naar de API worden gestuurd, worden niet gebruikt voor training. Je data blijft privé en wordt niet gebruikt om het basismodel te verbeteren.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.
Technische specificaties
Alle echte limieten en functies van de API op één plek — controleer ze voordat je opwaardeert.
| Onderdeel | Waarde |
|---|---|
| API-formaat | OpenAI-compatibel: elke OpenAI-SDK werkt — vervang alleen base URL en sleutel |
| Model-ID | uncensored |
| Authenticatie | Authorization: Bearer YOUR_KEY |
| Endpoints | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Max. uitvoer | tot de rest van het venster van 100.000 tokens; max_tokens optioneel (geen aparte limiet) |
| Parameters | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Function calling | ja — tools, tool_choice; antwoorden bevatten tool_calls, ook bij streaming; resultaten als role: tool |
| Streaming | ja — server-sent events; het laatste deel bevat het tokenverbruik |
| Contextvenster | 100.000 tokens (invoer + uitvoer) |
| JSON-modus | response_format: {"type": "json_object"} |
| Gelijktijdige verzoeken | tot 8 tegelijk per sleutel |
| Rate limit | 300 verzoeken per minuut per sleutel |
| Responsheaders | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Verzoekgrootte | tot 8 MB |
| Prijs | $0,15 per 1 mln invoertokens · $0,50 per 1 mln uitvoertokens |
| Afrekening | prepaid tegoed op basis van echt verbruik; fouten en weigeringen zijn gratis |
| Bonus | +5% vanaf $50, +10% vanaf $100, +15% vanaf $200 |
| Geldigheid | betaald tegoed verloopt niet, geen abonnement |
| Opwaarderen | USDT (TRC20) of USDC (Base), elk heel bedrag van $20 tot $500 |
| Gratis proeftegoed | $0,50 voor 7 dagen, zonder kaart · Proefsleutel: 2 parallelle verzoeken, 60 per minuut; volledige limieten (8 en 300) na eerste opwaardering |
| Sleutels | één actieve sleutel per account; een nieuwe vervangt de oude |
| Inloggen | Google of e-mail en wachtwoord |
| Inhoud | inhoud voor volwassenen toegestaan; seksuele inhoud met minderjarigen wordt geweigerd |
Foutcodes
Fouten komen als JSON met een vaste type; mislukte of geweigerde verzoeken kosten niets.
| Code | Type | Betekenis |
|---|---|---|
400 | bad_request | ongeldige JSON, lege berichten, verkeerde parameter of context te lang |
401 | missing_key · invalid_key · key_revoked | sleutel ontbreekt, is onjuist of is vervangen |
402 | no_credit | geen tegoed — waardeer op en ga direct verder |
403 | content_blocked | seksuele inhoud met minderjarigen — geweigerd, niet gerekend |
404 | not_found | onbekend endpoint |
413 | request_too_large | body groter dan 8 MB |
429 | rate_limited · concurrency | meer dan 300/min of 8 tegelijk — wacht en probeer opnieuw |
503 | upstream_busy | model bezet — probeer het over enkele seconden opnieuw |