base_url auf https://api.moonshot.ai/v1 zu setzen. /models aufrufen. Der List-Models-Endpunkt gibt die verfügbaren Modelle samt id zurück; diese id gehört in den Parameter model. model und messages senden. Die Kimi-Chat-Dokumentation zeigt Requests in dieser Struktur, die API-Übersicht nennt dazu den Pfad /chat/completions. /users/me/balance; für Batch-Verarbeitung gibt es /batches. Dieses Beispiel nutzt die von Kimi angegebene base_url für den OpenAI SDK. Wichtig:
KIMI_MODEL_ID sollte die id aus GET /models
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MOONSHOT_API_KEY"],
base_url="https://api.moonshot.ai/v1",
)
response = client.chat.completions.create(
model=os.environ["KIMI_MODEL_ID"],
messages=[
{"role": "user", "content": "Hallo, stell dich bitte kurz vor."}
],
)
print(response)Der erste Schritt sollte das Auflisten der Modelle im eigenen Moonshot-/Kimi-Konto sein, weil dieser Endpunkt die verwendbaren IDs zurückgibt.
curl -sS https://api.moonshot.ai/v1/models \
-H "Authorization: Bearer $MOONSHOT_API_KEY"Anschließend wählen Sie die passende id aus der Antwort und senden den Chat-Request an Chat Completions. Der vollständige Pfad /chat/completions und die Struktur mit model plus messages sind in der Kimi-Dokumentation beschrieben.
curl -sS https://api.moonshot.ai/v1/chat/completions \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "PASTE_MODEL_ID_FROM_MODELS",
"messages": [
{"role": "user", "content": "Schreibe eine kurze Einführung zu Kimi K2.6."}
]
}'Wenn ein Request an Billing oder Guthaben scheitert, können Sie den Kontostand über /users/me/balance prüfen; die Dokumentation zeigt dafür einen Bearer-Token im Authorization-Header.
curl -sS https://api.moonshot.ai/v1/users/me/balance \
-H "Authorization: Bearer $MOONSHOT_API_KEY"Ein häufiger Fehler ist, eine Model-ID von einem Drittanbieter zu kopieren und sie direkt beim offiziellen Moonshot-Endpunkt einzusetzen. AIMLAPI dokumentiert für Kimi K2.6 den Endpunkt https://api.aimlapi.com/v1/chat/completions mit dem Model moonshot/kimi-k2-6. OpenRouter zeigt auf seiner API-Seite die Model-ID
moonshotai/kimi-k2.6.
Diese IDs sind für das jeweilige Gateway gedacht. Wenn Sie dagegen https://api.moonshot.ai/v1/chat/completions direkt aufrufen, ist die robustere Vorgehensweise: GET https://api.moonshot.ai/v1/modelsid verwenden.
Die saubere Minimalstrecke lautet: API-Key setzen, OpenAI SDK mit https://api.moonshot.ai/v1 konfigurieren, per /models die tatsächliche Kimi-K2.6-Model-ID prüfen und anschließend /chat/completions mit model und messages aufrufen. So bleiben Sie nah an der OpenAI-kompatiblen Kimi-Dokumentation und vermeiden den klassischen Fehler, Gateway-spezifische IDs von AIMLAPI oder OpenRouter auf die offizielle Moonshot API zu übertragen.