DE ▾
API-Schlüssel erhalten

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

Ein Kabel, das zwischen zwei Buchsen auf einem Switchboard bewegt wird, veranschaulicht eine geänderte API Base URL
Isometrische Illustration eines Code-Editors, der über ein leuchtendes Kabel mit einem API-Server verbunden ist

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:

  1. Die Base URL, die entscheidet, wohin die Anfrage geht.
  2. Der API-Schlüssel, der pro Anbieter ausgestellt wird und nur auf den Servern dieses Anbieters funktioniert.
  3. 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_limited oder concurrency als 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.

FehlerSymptomLösung
Nur Host, kein /v1404 bei jedem AufrufFüge /v1 am Ende hinzu
Voller Pfad eingefügt404 mit einem verdoppelten Pfad im FehlerKürze die Adresse zurück auf /v1
Abschließender Slash plus manueller PfadDoppelter Slash in der URLSDK den Pfad verbinden lassen
Alter Schlüssel, neue URL401Verwende den Schlüssel des neuen Anbieters
Alte URL, neuer Schlüssel401 vom alten AnbieterRepo 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.

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.

API-Schlüssel erhaltenDokumentation lesen