kimiapikey.comLeitfaden
Moonshot API Base URL: Richte deinen Code woanders aus
Die moonshot api base url ist nur eine Zeichenkette in deinem OpenAI-Style-Client, und das Ändern ist, wie du denselben Code auf einen anderen Anbieter richtest. Diese Seite zeigt, wo diese Zeichenkette in Python, Node, curl und gängigen Tools lebt, und wie du sie auf einen alternativen Endpunkt ausrichtest.
Aktualisiert


Wichtige Punkte
- Die Base URL ist eine einzelne Einstellung; der Request-Body bleibt im OpenAI-Chat-Format.
- Ändere drei Dinge beim Wechsel: Base URL, API-Schlüssel, Modell-ID.
- Unser Endpunkt ist https://api.kimiapikey.com/v1 und die Modell-ID ist uncensored.
- Es ist ein unabhängiges gehostetes Modell, nicht der offizielle Dienst von Moonshot, also teste deine Prompts neu.
Was eine Base URL tatsächlich tut
OpenAI-kompatible Clients bauen jede Anfrage aus zwei Teilen zusammen: einer Base URL und einem Pfad. Das SDK verknüpft sie, sodass ein Aufruf von chat.completions.create zu einem POST an <base_url>/chat/completions wird. Anbieter, die dieses Format befolgen, darunter Moonshot, veröffentlichen ihre eigene Base URL in ihrer Dokumentation. Suche sie dort nach, statt sie aus einem Forum-Beitrag zu kopieren, denn das ist der Wert, den du nicht erraten kannst.
Das Wechseln des Anbieters erfordert daher drei Änderungen und sonst nichts:
- Die Base URL, die entscheidet, wohin die Anfrage geht.
- Der API-Schlüssel, der pro Anbieter ausgestellt wird und nur auf den Servern dieses Anbieters funktioniert.
- Die Modell-ID, weil jeder Anbieter seine Modelle anders benennt.
Nachrichten, Rollen, Streaming, Tools und JSON-Modus behalten dieselbe Form, weshalb die Migration kurz ist. Alles, was von einer anbieterspezifischen Funktion abhängt, wie ein integriertes Websuch-Tool, erfordert eine separate Behandlung.
Es hilft auch, die drei Werte zusammen in einem Konfigurationsblock oder einer Environment-Datei pro Anbieter zu halten. Wenn Base URL, Schlüssel und Modell-ID nebeneinander stehen, ist das Zurückwechseln eine Ein-Zeilen-Änderung, und du vermeidest den halb migrierten Zustand, in dem ein neuer Schlüssel mit einer alten Adresse gepaart ist.
Python: das openai-Paket
In Python setzt du die Base URL, wenn du den Client erstellst. Dieses Beispiel spricht den Endpunkt auf dieser Seite an:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
Wenn du den Code lieber ohne Einstellungen halten möchtest, nutze stattdessen die Environment-Variablen. Das SDK liest OPENAI_BASE_URL und OPENAI_API_KEY, wenn du OpenAI() ohne Argumente aufrufst, sodass eine Bereitstellung den Anbieter ohne Code-Änderung wechseln kann. Beachte, dass dies auch bedeutet, dass eine verbliebene Variable in deiner Shell einen Wert überschreiben kann, den du in der Datei geschrieben hast.
Node und curl
Das offizielle JavaScript-Paket verwendet denselben Optionsnamen, geschrieben in camel case:
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: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
Ohne SDK ist die Base URL einfach der vordere Teil der Adresse:
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":"Hello"}]}'
Dieser Endpunkt akzeptiert auch POST /v1/responses, und GET /v1/models listet auf, was er bereitstellt. Die Authentifizierung ist in jedem Fall ein Bearer-Token im Authorization-Header.
Editoren und Chat-Frontends
GUI-Tools exponieren die Base URL unter verschiedenen Bezeichnungen: "API base", "Override OpenAI Base URL", "Custom endpoint" oder "Provider URL". Der Wert, den du einfügst, ist dieselbe Zeichenkette wie im Code oben, endend bei /v1. Füge die vollständige /chat/completions-Adresse nicht ein, es sei denn, das Tool sagt, dass es die vollständige URL benötigt.
Nach dem Speichern füge die Modell-ID manuell hinzu, wenn das Tool keine Liste abruft. Einige Editoren validieren den Schlüssel gegen einen festen Anbieter und lehnen benutzerdefinierte Werte ab; suche in diesem Fall zuerst nach einer Einstellung, die den benutzerdefinierten oder OpenAI-kompatiblen Modus aktiviert. Der Artikel über die Verwendung eines Kimi-Style-API-Schlüssels in Cursor geht ein solches Tool im Detail durch.
Was sich ändert, wenn du Anbieter tauschst
Ein passendes Format bedeutet nicht identisches Verhalten. Bevor du Produktionsverkehr umstellst, prüfe diese Punkte einzeln:
- Ausgabestil. Ein anderes Modell schreibt anders. Führe deine echten Prompts aus, nicht nur ein Beispiel.
- Kontextgröße. Der Endpunkt hier hat ein 100.000-Token-Fenster für Prompt plus Completion. Wenn deine aktuelle Einrichtung längere Prompts sendet, kürze sie zuerst.
- Grenzwerte. Ein voller Schlüssel erlaubt 8 parallele Anfragen und 300 pro Minute. Über jedem Limit erhältst du HTTP 429, mit
rate_limitedoderconcurrencyals Code. - Funktionen. Streaming über SSE, Function Calling und JSON-Modus werden unterstützt. Bild-, Audio- und Videogenerierung, Embeddings sowie Fine-Tuning sind nicht verfügbar; dies ist eine Text-API.
- Namensgebung. Der Dienst betreibt ein Open-Weight-Modell, das ausgewählt wurde, um ohne Inhaltsablehnungen zu antworten für rechtmäßige Erwachsenennutzung. Es ist nicht Moonshots offizielle API und kein Router über Anbieter hinweg.
Eine neutrale Vergleichsmethode ist, dieselben zehn Prompts durch beide Endpunkte zu leiten und die Antworten nebeneinander zu lesen. Das dauert nur Minuten und spart Ratespielerei.
Base-URL-Fehler und wie sie aussehen
Die meisten Fehler nach einem Wechsel kommen von der Adresse, nicht vom Schlüssel. Hier siehst du, wie jeder Fehler auftritt und wie du ihn beheben kannst.
| Fehler | Symptom | Lösung |
|---|---|---|
Nur Host, kein /v1 | 404 bei jedem Aufruf | Füge /v1 am Ende hinzu |
| Voller Pfad eingefügt | 404 mit einem verdoppelten Pfad im Fehler | Kürze die Adresse zurück auf /v1 |
| Abschließender Slash plus manueller Pfad | Doppelter Slash in der URL | SDK den Pfad verbinden lassen |
| Alter Schlüssel, neue URL | 401 | Verwende den Schlüssel des neuen Anbieters |
| Alte URL, neuer Schlüssel | 401 vom alten Anbieter | Repo und Shell nach der alten Adresse durchsuchen |
http:// statt https:// | Umleitungs- oder Verbindungsfehler | Überall https verwenden |
Eine schnelle Methode, um Reste zu finden, ist, dein Projekt und deine Bereitstellungseinstellungen nach dem alten Hostnamen zu durchsuchen. Suche in .env-Dateien, CI-Variablen, Docker-Compose-Dateien und Editor-Einstellungen, da eine einzige vergessene Kopie ausreicht, um Traffic an den alten Anbieter zu senden.
Streaming und Tools nach dem Wechsel
Setze stream: true und die Antwort kommt als Server-Sent Events an, mit Token-Nutzungsangaben am Ende. Tool Calling nutzt die üblichen tools- und tool_choice-Felder, gestreamte tool_calls und Ergebnisse werden als Nachrichten mit role: "tool" zurückgesendet. Wenn dein Code dies bereits für den alten Anbieter behandelt, sollte es weiter funktionieren; bestätige dies, indem du eine gestreamte Anfrage und eine Tool Calling-Anfrage ausführst, bevor du vollständig umstellst. Denke daran, dass eine gestreamte Anfrage ihren Concurrency-Slot bis zum Ende des Streams hält.
Kostenprüfung vor dem Wechsel
Die Abrechnung erfolgt hier pro Token: $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token vom Prepaid-Guthaben, ohne Abo. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, und das Guthaben verfällt nicht. Für die Preise eines anderen Anbieters prüfe die aktuelle Preisliste, da sich diese ändern.
Ein durchgerechnetes Beispiel. Angenommen, eine Anfrage hat 2.000 Input-Token und 500 Output-Token:
- Input: 2.000 / 1.000.000 × $0,15 = $0,0003
- Output: 500 / 1.000.000 × $0,50 = $0,00025
- Gesamt: $0,00055 pro Anfrage, also kosten 1.000 Anfragen $0,55
Die minimale Aufladung beträgt $20, und größere Aufladungen bieten einen Bonus: +5% ab $50, +10% ab $100 und +15% ab $200. Krypto (USDT auf TRC20, USDC auf Base) wird akzeptiert. Vollständige Details findest du auf der Preisseite, und die auf Kimi fokussierte Aufschlüsselung findest du in Kimi API-Schlüssel-Preisen.
Hole dir einen Schlüssel und führe die erste Anfrage aus
Melde dich mit Google oder mit E-Mail und Passwort an und öffne die API-Schlüssel-Seite. Neue Nutzer können dort mit einem Klick $0,50 kostenloses Testguthaben beanspruchen, jeweils pro Person, gültig für 7 Tage und ohne Kartenangabe. Test-API-Schlüssel sind auf 2 parallele Anfragen und 60 pro Minute begrenzt, was für einen Testlauf mehr als ausreichend ist.
Füge den Schlüssel in den Python-Code oben ein, führe ihn aus, und bestätige, dass du Text zurückbekommst. Die Dokumentation listet alle Parameter auf, und die Antwort-Header X-Request-Id und X-Balance-USD helfen beim Debuggen und beim Verfolgen des Kontostands. Prompts, die an den Dienst gesendet werden, werden nicht zum Training verwendet.
Weitere Anleitungen
- Kimi API-Schlüssel funktioniert nicht: Ursachen, Lösungen, Fallback
- Verwende einen Kimi-ähnlichen API-Schlüssel in Cursor: Setup-Anleitung
Häufig gestellte Fragen
Ist das Modell dasselbe wie das offizielle Kimi von Moonshot?
Nein, wir hosten ein Open-Weight-Modell, das auf Unzensiertheit abgestimmt 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 Abonnement.
Fragen und Antworten
Muss ich meinen Code ändern, wenn ich die Base URL ändere?
Normalerweise nur drei Werte: Base URL, API-Schlüssel und Modell-ID. Das Nachrichtenformat, das Streaming und das Function Calling bleiben gleich, solange der neue Anbieter sie unterstützt.
Sollte die Base URL mit /v1 enden?
Ja für diesen Endpunkt: https://api.kimiapikey.com/v1. Das SDK fügt /chat/completions selbst hinzu, also gib es nicht ein.
Ist dies die offizielle Moonshot-API?
Nein. Es ist ein unabhängiges gehostetes Open-Weight-Modell hinter einer OpenAI-kompatiblen API. Es ist nicht der Dienst von Moonshot und kein Router über Anbieter hinweg.
Wo finde ich die Modell-ID?
Rufe GET /v1/models mit deinem Schlüssel auf. An diesem Endpunkt ist die Modell-ID uncensored.
Dein Schlüssel ist nur ein Formular entfernt
Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.