Die Moonshot API ist die Schnittstelle zur Kimi-Modellreihe. Der Schwerpunkt liegt auf langem Kontext, chinesischem Sprachverständnis und einem guten Preis-Leistungs-Verhältnis. Häufige Einsatzfelder sind das Lesen langer Dokumente, Wissensdatenbanken, Kundenservice und die Content-Erstellung.

Dieser Artikel erklärt, wie man die Moonshot API anspricht, wie der Aufruf aussieht und worauf bei der Integration zu achten ist.

Hinweis: Moonshot und Kimi sind Marken ihrer jeweiligen Inhaber. Der Artikel bezieht sich auf die im Oktober 2026 üblichen Versionen. Modellnamen und Preise richten sich nach den Modellpreisen.

1. Wofür sich die Moonshot API eignet

  • Zusammenfassung langer Dokumente, Verträge und Berichte.
  • Chinesische Fragen und Antworten sowie Kundenservice.
  • Wissensdatenbanken und RAG-Anwendungen.
  • Content-Erstellung und Überarbeitung.
  • Codeerklärung.

Die Modelle sind besonders dann sinnvoll, wenn große Textmengen in einem Zusammenhang betrachtet werden müssen. Für kurze Klassifikationen ist ein kleineres Modell meist günstiger und schneller.

2. Zugang zum API-Key

Offizielles Moonshot-Konto

Auf der offiziellen Entwicklerplattform registrieren, einen Key anlegen und Guthaben aufladen.

ZSQH AI Gateway

  1. Beim ZSQH AI Gateway registrieren.
  2. Einen Key anlegen und ein Limit setzen.
  3. Guthaben aufladen.
  4. Über das OpenAI SDK aufrufen.

3. Base URL

Beim offiziellen Moonshot lautet die Adresse üblicherweise:

https://api.moonshot.cn/v1

Das Gateway verwendet:

https://ai.zhongshangqihang.com/v1

Wie bei anderen Anbietern gilt: Key und Base URL müssen zusammenpassen. Ein Key des offiziellen Dienstes funktioniert nicht gegen den Gateway-Endpunkt.

4. Aufruf mit Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-IHR_KEY",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="moonshot-v1-8k",
    messages=[{"role": "user", "content": "Fasse den folgenden Text in drei Sätzen zusammen: ..."}],
)
print(resp.choices[0].message.content)

Der Modellname richtet sich nach der Preisseite. Modelle mit größerem Kontextfenster sind in der Regel teurer; für kurze Aufgaben sollte deshalb nicht automatisch das größte Modell gewählt werden.

5. Lange Texte sinnvoll verarbeiten

  1. Zuerst aufteilen oder zusammenfassen, nicht den gesamten Kontext auf einmal füllen.
  2. Quellenangaben beibehalten, damit Ergebnisse nachprüfbar bleiben.
  3. Anfragen mit langem Kontext sind langsamer und teurer; Timeouts entsprechend setzen.
  4. Für strukturierte Ausgaben JSON-Modus oder Tool-Aufrufe nutzen, sofern unterstützt.
  5. Wichtige Inhalte zusätzlich prüfen.

Ein häufiger Fehler besteht darin, ein ganzes Handbuch in eine Anfrage zu packen. Sinnvoller ist eine vorgelagerte Suche oder Zusammenfassung, die nur die relevanten Abschnitte an das Modell gibt.

6. Häufige Fehlermeldungen

Fehler Ursache Vorgehen
401 Key und Adresse passen nicht Key und Base URL prüfen
404 Modellname oder Pfad falsch Preisseite prüfen, /v1 bestätigen
429 Ratenlimit erreicht Parallelität senken, Wiederholung einplanen
Kontext überschritten Eingabe zu lang Aufteilen oder zusammenfassen
Guthaben reicht nicht Konto nicht aufgeladen Guthaben aufladen

7. Kosten steuern

  • Der lange Kontext ist der größte Kostenfaktor; zuerst zusammenfassen, dann fragen.
  • Für einfache Aufgaben ein Modell mit kurzem Kontext verwenden.
  • Batch-Aufgaben asynchron verarbeiten.
  • Wiederholungen und fehlgeschlagene Anfragen überwachen.

Bei Dokumenten mit vielen Seiten lohnt es sich, die Eingabelänge vor dem Aufruf zu schätzen. So lässt sich vermeiden, dass ein einzelner Lauf ein Vielfaches der geplanten Kosten erzeugt.

Häufige Fragen

Ist die Moonshot API dasselbe wie die Kimi-Webversion?

Nein. Die Webversion ist ein Produkt für Endnutzer, die API ist eine Schnittstelle für Programme. Abrechnung und Kontingente sind getrennt.

Wird das OpenAI SDK unterstützt?

Üblicherweise ist die Schnittstelle zu OpenAI Chat Completions kompatibel. Welche Parameter im Einzelnen unterstützt werden, ergibt sich aus der offiziellen Dokumentation und den Angaben des Gateways.

Ist der Zugang aus China stabil?

Moonshot ist eine chinesische Plattform und in der Regel stabiler erreichbar als ausländische Anbieter. Die konkrete Verbindung hängt vom eigenen Netzwerk ab.

Nächster Schritt

Wer einen einheitlichen Einstieg oder Modellwechsel braucht, kann sich beim ZSQH AI Gateway registrieren und zunächst lange Dokumente mit kleinen Mengen testen. Modelle und Preise stehen auf der Seite Modellpreise.

Weiterlesen: