kimiapikey.comDocs
Kimi API: Erste Anfrage in fünf Minuten
Erhalte deine erste Antwort in weniger als fünf Minuten über die standardmäßige OpenAI-kompatible Schnittstelle. Diese Anleitung behandelt Einrichtung, Authentifizierung und die grundlegende Nutzung des unzensierten Modells.
Voraussetzungen
Zum Start benötigst du einen API-Schlüssel von kimiapikey.com. Melde dich einfach mit E-Mail und Passwort an; für das Testguthaben wird keine Kreditkarte benötigt. Du benötigst zudem eine unterstützte Sprache mit installiertem offiziellem oder kompatiblen SDK. Unsere API folgt dem OpenAI chat-completions-Format, daher funktioniert bestehender Code für GPT-3.5/4 oft mit minimalen Änderungen. Stelle sicher, dass deine SDK-Version neu genug ist, um den Parameter base_url zu unterstützen.
Base URL und Authentifizierung
Unsere API befindet sich unter https://api.kimiapikey.com/v1. Die Authentifizierung erfolgt über den Standard-Authorization-Header. Übergebe deinen Schlüssel als Bearer-Token. Dies funktioniert mit jedem Client, der OpenAI-kompatible Endpunkte akzeptiert. Wenn du einen Proxy oder einen benutzerdefinierten Client verwendest, stelle sicher, dass er den Authorization-Header korrekt weiterleitet. Die Modell-ID, die du anfordern wirst, ist uncensored.
Erste Anfrage
Sende eine einfache Chat-Vervollständigung, um deine Einrichtung zu überprüfen. Verwende den folgenden curl-Befehl und ersetze YOUR_API_KEY durch deinen tatsächlichen Schlüssel. Diese Anfrage sendet einen kurzen Prompt an das uncensored-Modell. Bei Erfolg erhältst du eine JSON-Antwort mit der Antwort des Modells. Überprüfe das choices-Array auf den generierten Text. Wenn du einen 401-Fehler erhältst, ist dein Schlüssel ungültig oder abgelaufen.
Python SDK
Verwende für die einfachste Integration die offizielle OpenAI Python-Bibliothek. Lege den base_url auf unseren Endpunkt fest und gib deinen Schlüssel an. Dieses Beispiel demonstriert einen einfachen Textgenerierungsaufruf. Du kannst den Parameter model bei Bedarf anpassen, wobei uncensored der Standard ist. Dieser Ansatz hält deinen Code portabel über verschiedene OpenAI-kompatible Dienste hinweg.
Node SDK
Für JavaScript/TypeScript-Projekte verwende das openai npm-Paket. Konfiguriere den Client mit unserer Basis-URL und deinem API-Schlüssel. Dies ermöglicht es dir, Anfragen direkt aus deiner Node-Umgebung zu stellen. Die Syntax spiegelt das Python-SDK wider und gewährleistet Konsistenz, wenn du die Sprache wechselst. Denke daran, asynchrone Antworten korrekt mit await zu verarbeiten.
Streaming-Antworten
Für Echtzeit-Ausgaben aktiviere das Streaming in deinem SDK. Dies sendet Textblöcke, sobald sie generiert werden, und reduziert die wahrgenommene Latenz. Verwende das Flag stream in deiner Anfrage. Das SDK liefert teilweise Antworten, sodass du die Benutzeroberfläche inkrementell aktualisieren kannst. Dies ist ideal für Chat-Schnittstellen oder die Generierung langer Texte, bei denen sofortiges Feedback wertvoll ist.
Grenzen und Fehler
Jeder Schlüssel ist auf 300 Anfragen pro Minute begrenzt. Wird dieses Limit überschritten, erhältst du einen 429-Fehler. Der Körper deiner Anfrage darf 8 MB nicht überschreiten. Ein Kontextfenster von 100.000 Token gilt für die Summe aus Prompt und Vervollständigung. Häufige Fehler sind 401 (ungültiger Schlüssel) und 402 (unzureichendes Guthaben). Lade über das Dashboard auf, um die API weiter zu nutzen. Guthaben verfällt nie, und es gibt keine monatlichen Gebühren.
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)Fragen und Antworten
Unterstützt die API Function Calling?
Ja, der Endpunkt unterstützt Tool-/Function Calling im Standard-OpenAI-Format. Du kannst Tools in deiner Anfrage definieren, und das Modell gibt strukturierte Argumente zurück.
Was passiert, wenn ich das Ratenlimit überschreite?
Du erhältst einen 429 Too Many Requests-Fehler. Warte kurz und versuche es erneut, oder erhöhe dein Prepaid-Guthaben-Level, um einen höheren Durchsatz zu gewährleisten.
Wurde das Modell mit meinen Daten trainiert?
Nein. Prompts, die an die API gesendet werden, werden nicht zum Training verwendet. Deine Daten bleiben privat und werden nicht zur Verbesserung des Basismodells genutzt.
Dein Schlüssel ist nur ein Formular entfernt
Erstelle ein Konto, kopiere den Schlüssel, ändere die Base URL. Das ist die gesamte Einrichtung.
Technische Daten
Alle echten Grenzen und Funktionen der API auf einen Blick – prüfe sie, bevor du Guthaben kaufst.
| Merkmal | Wert |
|---|---|
| API-Format | OpenAI-kompatibel: jedes OpenAI-SDK funktioniert – nur Base-URL und Schlüssel ändern |
| Modell-ID | uncensored |
| Authentifizierung | Authorization: Bearer YOUR_KEY |
| Endpunkte | POST /v1/chat/completions · GET /v1/models |
| Base-URL | https://api.kimiapikey.com/v1 |
| Max. Ausgabe | bis zum Rest des 100.000-Token-Fensters; max_tokens optional (kein separates Limit) |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Function Calling | ja – tools, tool_choice; Antworten mit tool_calls, auch im Stream; Ergebnisse als role: tool |
| Streaming | ja – Server-Sent Events, der letzte Chunk enthält die Token-Nutzung |
| Kontextfenster | 100.000 Tokens (Eingabe + Ausgabe) |
| JSON-Modus | response_format: {"type": "json_object"} |
| Parallelität | 8 gleichzeitige Anfragen pro Schlüssel |
| Ratenlimit | 300 Anfragen pro Minute und Schlüssel |
| Antwort-Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Anfragegröße | bis 8 MB |
| Preis | $0,15 pro 1 Mio. Eingabe-Tokens · $0,50 pro 1 Mio. Ausgabe-Tokens |
| Abrechnung | Prepaid-Guthaben nach echter Nutzung; Fehler und Ablehnungen sind kostenlos |
| Bonus | +5 % ab $50, +10 % ab $100, +15 % ab $200 |
| Gültigkeit | bezahltes Guthaben verfällt nie, kein Abo |
| Aufladen | USDT (TRC20) oder USDC (Base), jeder ganze Betrag von $20 bis $500 |
| Testguthaben | $0,50 für 7 Tage, ohne Karte · Testschlüssel: 2 parallele Anfragen, 60 pro Minute; volle Limits (8 und 300) nach erster Aufladung |
| Schlüssel | ein aktiver Schlüssel pro Konto; ein neuer ersetzt den alten |
| Anmeldung | Google oder E-Mail und Passwort |
| Inhalte | Inhalte für Erwachsene erlaubt; sexuelle Inhalte mit Minderjährigen werden abgelehnt |
Fehler und Lösungen
Fehler kommen als JSON mit festem type; fehlgeschlagene oder abgelehnte Anfragen kosten nichts.
| Code | Typ | Bedeutung |
|---|---|---|
400 | bad_request | ungültiges JSON, leere Nachrichten, falscher Parameter oder Kontext zu lang |
401 | missing_key · invalid_key · key_revoked | Schlüssel fehlt, ist falsch oder wurde ersetzt |
402 | no_credit | kein Guthaben – aufladen, dann geht es sofort weiter |
403 | content_blocked | sexuelle Inhalte mit Minderjährigen – abgelehnt, nicht berechnet |
404 | not_found | unbekannter Endpunkt |
413 | request_too_large | Anfrage größer als 8 MB |
429 | rate_limited · concurrency | über 300/Min. oder 8 parallel – kurz warten |
503 | upstream_busy | Modell ausgelastet – in Sekunden erneut versuchen |