Die Moonshot API ist die Schnittstelle der Open Platform von Moonshot AI. 2026 hat sich die Plattform deutlich verändert: Die Entwicklerkonsole ist zu platform.kimi.com umgezogen, die Hauptmodelle sind Kimi K3 und die K2.7-Reihe, und die alte moonshot-v1-Reihe wurde am 31. August 2026 eingestellt. Viele Teams beschreiben „kein Zugang in China“, obwohl tatsächlich Einstiegspunkt, Modellname oder Kontoregion nicht zusammenpassen – nicht das Netzwerk.

Dieser Beitrag vergleicht drei Wege: Direktverbindung, selbst betriebener Proxy und inländisches AI-Gateway. Dazu kommen Netzwerk, Zahlung und Rechnungsstellung, Rate-Limits und eine Abnahmemethode für Failover. Modelle und Preise richten sich nach den Modellpreisen auf dieser Website.

Hinweis: Moonshot, Kimi und Moonshot AI sind Marken oder eingetragene Marken von Beijing Moonshot Technology Co., Ltd. Dieser Beitrag dient der technischen Erläuterung und begründet keine Zugehörigkeit zu den Rechteinhabern; Schnittstellen, Modelle und Abrechnungsregeln richten sich nach der offiziellen Dokumentation.

1. Zuerst klären, welche Plattform Sie ansprechen

Bei der Moonshot API gibt es drei leicht zu verwechselnde Ebenen; ein Fehler auf jeder Ebene führt zu einem Fehler:

  • Markenebene: Moonshot AI ist der Firmenname, Kimi der Modell- und Produktname; es sind keine zwei getrennten Dienste.
  • Plattformebene: Die chinesische Site ist platform.kimi.com, die internationale platform.kimi.ai. Konten, Guthaben und Keys sind vollständig getrennt; eine Vermischung führt zu 401.
  • Schnittstellenebene: In China wird meist https://api.moonshot.cn/v1 verwendet; die internationale Site nutzt eine andere Domain, maßgeblich ist die offizielle Dokumentation.

Außerdem sind Keys der Open Platform, Kimi-Client-Mitgliedschaften und Kimi Code nicht austauschbar. Ein Key aus dem Client-Kontext scheitert an der Open Platform ebenfalls bei der Authentifizierung. Zuerst klären, auf welcher Plattform Sie registriert sind und zu welcher Produktlinie der Key gehört, dann über Netzwerkoptimierung sprechen.

2. Drei Wege in einer Tabelle

Dimension Offizielle Direktverbindung Eigener Proxy Inländisches AI-Gateway
Einstieg api.moonshot.cn und weitere offizielle Adressen Eigene Domain als Reverse-Proxy Einheitliche OpenAI-kompatible Gateway-Adresse
Konto und Abrechnung Offizielles Konto, Aufladung in Yuan Offizielle Rechnung plus Serverkosten Gateway-Konto, einheitliche Rechnung in Yuan
Modellauswahl Nur Moonshot/Kimi Abhängig von der Proxy-Konfiguration Mehrere Anbieter, je nach Freischaltung
Betriebsverantwortung Anbieter und lokales Netz Vollständig beim Team Geteilt zwischen Dienstleister und Team
Geeignet für Ein Modell, stabiler Zugang, eigene Behandlung von Limits Betriebskompetenz, einheitlicher Ausgang und Audit Mehrere Modelle, Rechnungen, wenig Betrieb

Kein Weg passt für alle. Die Entscheidungsreihenfolge: Kann das Geschäft Unterbrechungen akzeptieren, werden mehrere Modelle und eine einheitliche Rechnung gebraucht, und hat das Team jemanden für Retries und Monitoring? Sind alle drei Punkte einfach, genügt die Direktverbindung; wird einer komplex, kommt eine Schicht hinzu.

3. Netzwerk: die vier tatsächlichen Prüfpunkte

Für den Zugang zur Moonshot API in China sind meist keine zusätzlichen Netzwerkwerkzeuge nötig. Vier Problemklassen werden aber häufig als „Netzwerk nicht erreichbar“ fehlgedeutet:

  1. Region und Key passen nicht zusammen: Ein Key der chinesischen Site an der internationalen Adresse oder umgekehrt führt direkt zu 401. Das ist kein DNS-Problem.
  2. Firmenproxy und TLS-Interception: Ein Unternehmensproxy, der Zertifikate ersetzt, oder fehlerhafte DNS-Auflösung äußern sich als Zertifikatsfehler, Timeout oder 499.
  3. Timeouts bei langen Anfragen: Reagiert der Server bei nicht gestreamten Anfragen lange nicht, kann das Gateway 504 liefern; die offizielle Dokumentation nennt den Fall nach 900 Sekunden. Lange Textgenerierung sollte standardmäßig streamen.
  4. IP-Whitelist der internationalen Site: Die internationale Site kann Aufruf-IPs beschränken; ohne Eintrag in der Organisations-Whitelist kommt 403. Ein Netzwerkwechsel hilft nicht, die Konfiguration muss in der Konsole erfolgen.

In Produktion zudem Verbindungs-Reuse aktivieren, damit nicht jede Anfrage neu aushandelt; für Streaming Idle-Timeout und Heartbeat setzen, damit Zwischenproxys Verbindungen ohne Daten nicht trennen.

4. Zahlung und Rechnungen: hier stockt die Einführung oft

Technisch zu funktionieren heißt nicht, in Produktion gehen zu können; Beschaffung und Finanzen sind oft der Engpass. Nach der offiziellen Beschreibung von 2026 benötigt die Unternehmensverifizierung Firmenname, ein Firmenkonto mit identischem Namen und den einheitlichen Sozialkreditcode; die Plattform überweist einen zufälligen Betrag zur Prüfung der Kontoinhaberschaft. Privatkonten lassen sich zu Unternehmenskonten hochstufen, umgekehrt ist die Änderung nicht möglich.

Bei der Aufladung können Privatpersonen WeChat oder Alipay nutzen; Unternehmen haben Online-Aufladung und Banküberweisung. Die Überweisung muss vom verifizierten Konto ausgehen, wird üblicherweise in 1 bis 5 Werktagen gutgeschrieben und benötigt etwa 10 Minuten für die Buchung. Rechnungen lassen sich online nach Verbrauch oder Aufladung beantragen; Rechnungssteller ist Beijing Moonshot, Kategorie technische Dienstleistung. Bei Unternehmenskonten muss der Rechnungsempfänger die verifizierte Partei sein; nur Privatkonten können privat oder Firma wählen.

Verlangt das Unternehmen Vertrag, Zahlungsziel oder spezielle Rechnungen, zuerst den Vertriebsweg klären und nicht erst nach der Aufladung feststellen, dass der Prozess nicht passt. Die Zahlungs- und Rechnungsregeln der Gateways unterscheiden sich; auch dort vor Vertragsabschluss schriftlich bestätigen.

5. Rate-Limits: 429 ist nicht ein Fehler

Die Tarifstufe der Moonshot API richtet sich nach der kumulierten Aufladung; je höher die Stufe, desto großzügiger Parallelität, RPM, TPM und TPD. Gutscheine zählen üblicherweise nicht zur Kumulierung, „Gutscheine gekauft“ hebt die Stufe also nicht zwangsläufig. Die QPS der Websuche ist ein separates Kontingent und wird getrennt von RPM und TPM des Chat-Endpunkts gerechnet.

Bei gleichem 429 unterscheidet sich die Behandlung vollständig:

  • engine_overloaded_error: Server überlastet; nach Retry-After zurückweichen. Aufladen oder Stufenwechsel helfen nicht.
  • rate_limit_reached_error: Parallelität, RPM, TPM oder TPD der Organisation überschritten; drosseln, einreihen oder auf den Reset warten.
  • exceeded_current_quota_error: Zahlungsrückstand oder zu wenig Kontingent; nicht wiederholen, zuerst das Guthaben klären.

Zusätzlich kann die Plattform bei auffälligen Konten eine Risikosperre auslösen, die laut offizieller Beschreibung nach dem Auslösen möglicherweise nicht aufgehoben wird. Projekte können ein Tagesbudget setzen; nach Erreichen werden alle Anfragen des Projekts abgelehnt, mit etwa 10 Minuten Verzögerung durch die Abrechnung. Guthabenwarnungen per SMS aktivieren, statt den 429 abzuwarten.

6. Failover: nur bei vorübergehenden Fehlern sinnvoll

Failover bedeutet nicht, bei jedem Fehler den Pfad zu wechseln. Fehlendes Guthaben, falsche Keys, Parameterfehler und Inhaltsfilter lassen sich auch über einen anderen Kanal nicht lösen und erhöhen Rechnung und Fehlersuche. Ein minimales Beispiel:

import os
from openai import OpenAI

clients = [
    OpenAI(api_key=os.environ["PRIMARY_KEY"],
           base_url=os.environ["PRIMARY_BASE"], max_retries=0),
    OpenAI(api_key=os.environ["BACKUP_KEY"],
           base_url=os.environ["BACKUP_BASE"], max_retries=0),
]

def ask(prompt: str) -> str:
    last_error = None
    for client in clients:
        try:
            resp = client.chat.completions.create(
                model=os.environ["MODEL"],
                messages=[{"role": "user", "content": prompt}],
                max_completion_tokens=512,
                stream=False,
            )
            return resp.choices[0].message.content
        except Exception as exc:  # in Produktion nach error.type unterscheiden
            last_error = exc
            if "quota" in str(exc).lower() or "content_filter" in str(exc).lower():
                raise
    raise RuntimeError("Haupt- und Ersatzkanal nicht verfuegbar") from last_error

Beachten: Konten der chinesischen und internationalen Site sind getrennt; „geografisches Disaster-Recovery“ darf nicht nur die Base URL ändern. Der Ersatzkanal muss vorab registriert, aufgeladen und separat geprüft werden. Nach dem Wechsel request_id, Modellname, usage und Dauer protokollieren, sonst lässt sich nicht belegen, ob der Ersatzkanal tatsächlich arbeitet.

7. Abnahmecheckliste vor dem Start

  1. Mit einem aktuell angebotenen Modell (etwa kimi-k3, kimi-k2.6) eine minimale Anfrage senden und 200 prüfen.
  2. Chat Completions, Responses und Anthropic Messages einzeln prüfen, damit alle im Projekt genutzten Protokolle funktionieren.
  3. Prüfen, ob model, usage und request_id in der Antwort vorhanden und protokollierbar sind.
  4. Streaming mit langer Ausgabe testen: blockweise Rückgabe, vollständiges Ende, kein Puffern durch Zwischenproxys.
  5. Gezielt 401, 404 und 429 auslösen und prüfen, ob der Client die Fehlertypen korrekt unterscheidet.
  6. Verbindungs- und Lese-Timeout setzen, Keep-Alive aktivieren, Tagesbudget und Guthabenwarnung konfigurieren.
  7. Eine Woche lang p50- und p95-Latenz sowie 429- und 5xx-Anteil beobachten, nicht nur einen Lasttest.
  8. Banküberweisung und Rechnungsprozess einmal durchlaufen und Vertrag, Rechnung und Rückerstattungsregeln prüfen.
  9. Einen rückrollbaren Direktkanal behalten und die Wechselbedingungen dokumentieren.

Ohne bestandene Abnahme keine Kernprozesse umstellen. Ein Gateway bringt einen zusätzlichen Hop und eventuell etwas Latenz; sein Wert liegt in einheitlichem Einstieg, Failover, Abrechnung und Key-Isolation, nicht in „Beschleunigung“.

Häufig gestellte Fragen

Sind Moonshot API und die Kimi-Webversion dasselbe?

Nein. Die Webversion ist ein Endnutzerprodukt, die Moonshot API eine Entwicklerschnittstelle der Open Platform; Kontosystem, Abrechnung und Keys unterscheiden sich.

Braucht die Direktverbindung in China zusätzliche Netzwerkwerkzeuge?

Üblicherweise nicht. Moonshot ist ein chinesischer Anbieter, die chinesische Site ist im Inland direkt erreichbar. Häufig sind eher Region, Key, Modellname und Proxy-Konfiguration falsch.

Funktioniert alter moonshot-v1-Code weiter?

Die moonshot-v1-Reihe wurde am 31. August 2026 eingestellt; weitere Aufrufe liefern 404. Nach der offiziellen Modellliste auf kimi-k3, kimi-k2.7 oder kimi-k2.6 migrieren und die Parameter erneut prüfen.

Ist Banküberweisung für Unternehmen Pflicht?

Nein. Nach der Verifizierung stehen WeChat, Alipay und Banküberweisung zur Wahl; die Überweisung ist langsamer und passt zu Teams mit Finanzprozessen.

Was tun, wenn 429 nicht verschwindet?

Zuerst error.type prüfen. Bei zu wenig Guthaben aufladen; bei Parallelität oder TPD drosseln und auf den Reset warten; bei Serverüberlastung nach Retry-After zurückweichen. Bleibt es bestehen, request_id sichern und den Support kontaktieren.

Nächster Schritt

Wenn Sie mehrere Modelle nutzen, eine einheitliche Rechnung oder einen Ersatzkanal brauchen, erstellen Sie zunächst einen Test-Key im ZSQH AI Gateway und vergleichen Sie mit derselben Anfrage Latenz, Fehlerrate und Rechnung von Direktverbindung und Gateway, bevor Sie den Produktionsweg festlegen. Modelle und Abrechnung richten sich nach den Modellpreisen.

Weiterführende Beiträge: