Zum Inhalt springen
Azamol AI — Intelligent Assistance Solutions

Kimi K3.1 Pro API einrichten: Schritt-für-Schritt-Anleitung mit dem OpenAI SDK

Autor:
Kimi K3.1 Pro API Kurulumu: OpenAI SDK ile Adım Adım Rehber

Die Einrichtung der Kimi K3.1 Pro API dauert vier Schritte: Erstellen Sie in der Konsole der Kimi API Platform einen API-Schlüssel, speichern Sie ihn in der Umgebungsvariablen MOONSHOT_API_KEY, installieren Sie das OpenAI Python SDK mit python3 -m pip install --upgrade 'openai>=1.0' und setzen Sie im Client base_url auf https://api.moonshot.ai/v1 und das Modell auf kimi-k3.1-pro. Moonshot AI hat K3.1 Pro am 23. Oktober 2026 veröffentlicht; es ist ein Open-Weight-Modell mit 1M Token Kontext. Die wichtigste Einstellung danach ist reasoning_effort: Der Standardwert ist max, jede Anfrage läuft also auf der höchsten Denkstufe.

Was ist Kimi K3.1 Pro und wofür eignet es sich?

Kimi K3.1 Pro ist das erste Modell der K3.1-Serie von Moonshot AI. Der Tech-Blog des Unternehmens beschreibt es als nachtrainierte Version von Kimi K3 und als bislang leistungsfähigstes Open-Weight-Modell der 3T-Klasse. Laut Modellkarte hat K3.1 Pro insgesamt 2,8 Billionen Parameter, davon sind pro Token 104 Milliarden aktiv; das Kontextfenster umfasst 1.048.576 Token. Das Modell verarbeitet Text und Bilder, laut offizieller Anleitung auch Videos über hochgeladene Dateien. Die Variante kimi-k3.1-pro-highspeed bietet dieselben Fähigkeiten mit 2-3-facher Geschwindigkeit.

Moonshot positioniert Kimi K3.1 Pro für Programmierung, Finanzen und 3D-Design. Nach eigener Messung erreicht es im Terminal-Bench 4.0 65,7 %, für Claude Opus 5.5 werden 66,4 % angegeben. In unabhängigen Tests führt Vals AI das Modell mit 62,52 Punkten auf Platz 9 von 34 im Vals Index und nennt den 23. Oktober 2026 als Veröffentlichungsdatum. Neben der Kimi API bieten 17 Anbieter das Modell über OpenRouter an.

Welche Voraussetzungen und Anforderungen gelten für die Einrichtung der Kimi K3.1 Pro API?

Für Kimi K3.1 Pro über die API brauchen Sie fünf Dinge:

  • Konto bei der Kimi API Platform und API-Schlüssel: Laut allgemeinem Schnellstart erstellen Sie den Schlüssel nach der Anmeldung auf der Seite API Keys. Schreiben Sie ihn nicht in den Code; warum, erklärt unser Artikel zum Northflank-Leck.
  • Mindestens 1 US-Dollar Guthaben: Laut K3.1-Pro-Anleitung bleibt das Modell gesperrt, bis mindestens 1 US-Dollar aufgeladen ist. Auch die Ratenlimits richten sich nach der gesamten Aufladung.
  • Python 3.9 oder neuer: Mit Node.js brauchen Sie Version 18 oder neuer.
  • OpenAI SDK 1.0.0 oder neuer: Die Kimi API folgt dem OpenAI-Format, eine eigene Kimi-Bibliothek ist nicht nötig.
  • Terminal: Die export-Zeile unten gilt für eine macOS- oder Linux-Shell. Unter Windows setzen Sie die Umgebungsvariable auf dem Weg Ihrer eigenen Shell.

Wie richten Sie die Kimi K3.1 Pro API Schritt für Schritt ein?

Die Einrichtung von Kimi K3.1 Pro folgt dem offiziellen Python-Beispiel von Moonshot; die Codeblöcke unten stammen unverändert aus der offiziellen Dokumentation.

Schritt 1 — Schlüssel in einer Umgebungsvariablen speichern. Die Beispiele lesen den Schlüssel aus MOONSHOT_API_KEY. Ersetzen Sie den Wert in Anführungszeichen durch Ihren Schlüssel:

bash
export MOONSHOT_API_KEY="YOUR_KIMI_API_KEY"

Schritt 2 — OpenAI SDK installieren. Dieser Befehl aktualisiert das SDK auf Version 1.0 oder neuer:

bash
python3 -m pip install --upgrade 'openai>=1.0'

Schritt 3 — Client auf den Kimi-Endpunkt richten. Die einzige Kimi-spezifische Einstellung ist die Zeile base_url:

python
import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

Schritt 4 — Erste Anfrage senden. Fügen Sie diesen Teil in derselben Python-Datei unter dem Client ein und führen Sie die Datei mit Python aus; die Antwort des Modells erscheint im Terminal:

python
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}],
)

print(completion.choices[0].message.content)

Schritt 5 — Denkstufe wählen. Bei Kimi K3.1 Pro ist das Denken immer aktiv und lässt sich nicht abschalten; das Feld reasoning_effort bestimmt den Umfang. Das offizielle Beispiel setzt die höchste Stufe ausdrücklich:

python
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="max",
    messages=[{"role": "user", "content": "Prove that the square root of 2 is irrational."}],
)

print(completion.choices[0].message.content)

Das Feld akzeptiert low, high und max. Ohne Angabe gilt max. Für kurze Aufgaben wie das Beantworten von Kundenfragen vergleichen Sie low und high mit eigenen Beispielen.

Wie prüfen Sie, ob die Einrichtung von Kimi K3.1 Pro funktioniert?

Am schnellsten prüfen Sie die Einrichtung von Kimi K3.1 Pro unabhängig von Python mit der curl-Anfrage aus der offiziellen Anleitung. Sie nutzt dieselbe Variable MOONSHOT_API_KEY:

bash
curl https://api.moonshot.ai/v1/chat/completions \
  --header "Authorization: Bearer $MOONSHOT_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "kimi-k3.1-pro",
    "messages": [{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}]
  }'

Die Antwort kommt im OpenAI-Format zurück, der Text steht in choices[0].message.content. Auch das Python-Beispiel liest die Antwort aus completion.choices[0].message.content. Kimi-Modelle liefern nicht jedes Mal exakt dieselbe Antwort, prüfen Sie also auf eine sinnvolle Antwort statt auf einen identischen Satz. Funktioniert curl, Python aber nicht, liegt das Problem meist an der SDK-Version oder an der Zeile base_url.

Was sind häufige Fehler bei Kimi K3.1 Pro, und wie gelingt die Fehlerbehebung?

Die meisten Fehler mit Kimi K3.1 Pro entstehen aus Gewohnheiten von OpenAI-Modellen. Nach den Grenzen in der offiziellen Anleitung sind das die wichtigsten Fälle:

SymptomUrsacheLösung
Das Modell erscheint im Konto gesperrtEs wurde noch kein Guthaben aufgeladenMindestens 1 US-Dollar aufladen
Ihre Einstellung für temperature oder top_p ändert nichtsDiese Werte sind bei K3.1 Pro fest (temperature=1.0, top_p=0.95)Parameter aus der Anfrage entfernen und das Verhalten über Anweisungen steuern
Mehrstufiger Chat oder Tool-Aufrufe liefern nicht das erwartete ErgebnisAus der vorigen Antwort wird nur content zurückgeschicktDie vollständige Assistentennachricht mit reasoning_content und tool_calls an messages anhängen
Eine Anfrage mit Bild schlägt fehlÖffentliche Bild-URLs werden nicht unterstütztBild als base64 oder als ms://<file-id> senden
JSON-Ausgabe lässt sich nicht parsenDer Code liest das Feld reasoning_contentjson_schema-Ausgabe nur aus message.content parsen
Antworten sind langsam und teurer als erwartetDer Standardwert von reasoning_effort ist maxFür kurze Aufgaben low oder high testen; für Tempo kimi-k3.1-pro-highspeed prüfen

Ein weiterer Hinweis: Laut Anleitung wird das offizielle Websuche-Werkzeug überarbeitet und ist für Produktionsabläufe vorerst nicht empfohlen. Braucht Ihr Assistent aktuelle Informationen, führen Sie die Suche mit einem eigenen Werkzeug aus.

Auf welchem Weg sollten Sie Kimi K3.1 Pro nutzen?

Kimi K3.1 Pro ist auf drei Wegen erreichbar, mit jeweils anderen Folgen für Daten und Lizenz. Die Tabelle haben wir aus der offiziellen Dokumentation und dem Lizenztext zusammengestellt:

WegEinrichtungsaufwandWer verarbeitet die DatenLizenzseite
Kimi APISchlüssel, OpenAI SDK, base_urlMoonshot AI; Zero Data Retention ist verfügbarNutzung über offizielle Moonshot-Produkte ist ausgenommen
Drittanbieter (z. B. Anbieter auf OpenRouter)Schlüssel und Endpunkt des AnbietersDer gewählte AnbieterDie Ausnahme gilt laut Text nur für zertifizierte Inferenzpartner; beim Anbieter nachfragen
Eigene ServerMulti-GPU-Server mit vLLM, SGLang oder TokenSpeedIhre InfrastrukturInterne Nutzung ist ausgenommen; wer das Modell anderen als Dienst anbietet, prüft die Umsatzschwelle

Was kostet ein KI-Assistent mit Kimi K3.1 Pro pro Monat?

Im folgenden Beispiel kostet ein KI-Assistent mit 10.000 Kundengesprächen im Monat 230 US-Dollar für die Nutzung von Kimi K3.1 Pro. Als Preis haben wir die Werte von Vals AI verwendet: 2 US-Dollar pro Million Eingabe-Token und 10 US-Dollar pro Million Ausgabe-Token. Die Tabelle auf Kimis Preisseite war für uns nicht abrufbar, prüfen Sie den aktuellen Preis daher vor der Budgetplanung in der Konsole. Wir gehen von 4.000 Eingabe- und 1.500 Ausgabe-Token einschließlich Denken pro Gespräch aus; das sind unsere Beispielwerte, keine Angaben von Moonshot.

  1. Eingabe: 10.000 × 4.000 = 40 Millionen Token; 40 × 2 = 80 US-Dollar.
  2. Ausgabe: 10.000 × 1.500 = 15 Millionen Token; 15 × 10 = 150 US-Dollar.
  3. Monatssumme: 80 + 150 = 230 US-Dollar.
  4. Werden Gespräche gesammelt statt live verarbeitet, berechnet die Batch API laut Preisseite 60 % des Standardpreises: 230 × 0,6 = 138 US-Dollar.

Den Ausgabeanteil haben wir hoch angesetzt, weil das Denken auf der Standardstufe max lange dauern kann. Wiederholte Systemanweisungen werden automatisch zwischengespeichert und gecachte Eingaben günstiger berechnet, die echte Rechnung kann also abweichen. Die Rechnung umfasst nur die Modellnutzung; WhatsApp- oder Telefonkosten, Integration und Wartung sind nicht enthalten.

Worauf sollten Sie vor dem Livegang von Kimi K3.1 Pro achten?

Klären Sie vor dem Livegang von Kimi K3.1 Pro vier Punkte:

  • Sprachqualität: Die Modellkarte nennt keine unterstützten Sprachen. Die Systemanweisung im offiziellen Beispiel beschreibt das Modell als besonders gut in Gesprächen auf Chinesisch und Englisch. Testen Sie die Qualität auf Deutsch mit eigenen Kundenanfragen und legen Sie die Antwortsprache in der Systemanweisung ausdrücklich fest.
  • DSGVO: Bei personenbezogenen Daten verlangt Art. 28 DSGVO einen bindenden Vertrag mit dem Auftragsverarbeiter, der nur nach dokumentierten Weisungen handeln darf. Zero Data Retention bei der Kimi API ersetzt diesen Vertrag nicht. Lassen Sie sich Auftragsverarbeitungsvertrag und Verarbeitungsregion schriftlich bestätigen. Das ist keine Rechtsberatung.
  • Lizenzschwellen: Laut Lizenz brauchen Unternehmen, die das Modell per API anderen als Dienst anbieten und in den letzten 12 Monaten mehr als 20 Millionen US-Dollar Umsatz erzielt haben, einen separaten Vertrag mit Moonshot. Produkte mit mehr als 100 Millionen monatlich aktiven Nutzern oder mehr als 20 Millionen US-Dollar Monatsumsatz müssen den Namen „Kimi K3.1-Pro“ in der Oberfläche zeigen. Die meisten mittelständischen Unternehmen liegen deutlich darunter.
  • Sicherheitsaufgaben: Moonshot hat nach eigenen Angaben cyberbezogene Trainingsdaten aus der Open-Weight-Version entfernt. Wählen Sie ein Modell für Sicherheitsanalysen, berücksichtigen Sie diese Einschränkung.

Mit welcher Version von Kimi K3.1 Pro wurde diese Anleitung erstellt?

Die Schritte in dieser Anleitung gelten für die Modell-ID kimi-k3.1-pro und den Endpunkt https://api.moonshot.ai/v1. Laut offizieller Anleitung liegt max_completion_tokens standardmäßig bei 131072 und lässt sich bis 1048576 erhöhen. Da das SDK mit der Bedingung openai>=1.0 installiert wird, erhalten Sie die an diesem Tag aktuelle OpenAI-Version; fixieren Sie die Version für den Produktivbetrieb in Ihrer eigenen Abhängigkeitsdatei. Für das schnellere Modell genügt es, die Modell-ID auf kimi-k3.1-pro-highspeed zu ändern.

Was bedeutet diese Einrichtung für Ihr Unternehmen?

Für Unternehmen, die mit langen Dokumenten arbeiten und ein anderes Modell mit wenig Änderungen am bestehenden OpenAI-Code testen wollen, ist die Einrichtung von Kimi K3.1 Pro ein günstiger Versuch. Nehmen Sie einen mittelständischen Maschinenbauer, dessen Vertrieb vor jedem Angebot umfangreiche Lastenhefte prüft. Mit 1M Token Kontext kann er ein ganzes Lastenheft in einer Anfrage übergeben und Fragen zur Erfüllbarkeit stellen. Nutzt sein Code bereits das OpenAI SDK, bedeutet der Wechsel nur neue Werte für Schlüssel, base_url und Modell. Die eigentliche Arbeit liegt darin, die Antwortqualität auf Deutsch zu messen und die Auftragsverarbeitung nach DSGVO zu klären.

Für wen es passt und für wen nicht:

  • Passend: Unternehmen mit langen Verträgen, Lastenheften oder Finanzunterlagen, Teams mit Coding-Agenten, Firmen mit einer bestehenden Integration auf Basis des OpenAI SDK und Zugang zu mindestens einem Entwickler.
  • Nicht passend: Betriebe ohne Entwicklerkapazität kommen mit einem fertigen KI-Assistenten-Service schneller ans Ziel als mit einer eigenen API-Anbindung. Wer am Telefon sofortige Antworten braucht, spürt die Verzögerung durch langes Denken auf der Standardstufe max. Wer Kundendaten nicht an externe Anbieter geben darf und keine Multi-GPU-Server hat, sollte ebenfalls anders wählen.

Drei Schritte für diese Woche:

  1. Senden Sie 50 echte Kundenfragen ohne personenbezogene Daten mit low und max an K3.1 Pro; erfassen Sie Genauigkeit und Antwortzeit.
  2. Lassen Sie sich schriftlich geben, welcher Anbieter in welchem Land Ihre Daten verarbeitet und welche Bedingungen für Zero Data Retention gelten.
  3. Setzen Sie Ihr monatliches Gesprächsvolumen in die Rechnung oben ein und vergleichen Sie das Ergebnis mit der Rechnung Ihres aktuellen Modells.

Brauchen Sie eine günstigere Klassifizierungsschicht, lesen Sie unsere Anleitung zur Einrichtung der Claude Haiku 5.5 API; wie Sie einen Assistenten mit Ihrer Website verbinden, zeigt unsere Anleitung zur Assistenten-Einrichtung. Für mehrstufige Abläufe, die ein langes Dokument lesen und dann einen CRM-Eintrag anlegen oder ein Angebot entwerfen, passt unser KI-Agent-Service; für Kundennachrichten über WhatsApp unser Service für WhatsApp-Automatisierung. Fertige Szenarien können Sie auf unserer Demo-Seite ausprobieren.

Quellen

Zuletzt geprüft: 8. November 2026.

Nächster Schritt

Um Kimi K3.1 Pro oder ein anderes Modell an Ihre Abläufe anzupassen, besuchen Sie unsere Seite zum KI-Assistenten, fordern Sie über unser Kontaktformular ein kurzes Erstgespräch an oder rufen Sie unter +90 850 840 08 23 an und sprechen Sie live mit Azra, unserer Sprachassistentin.

Häufig gestellte Fragen

Ist die Kimi K3.1 Pro API kostenpflichtig?

Ja. Das Modell wird freigeschaltet, sobald mindestens 1 US-Dollar aufgeladen ist. Vals AI nennt 2 US-Dollar pro Million Eingabe-Token und 10 US-Dollar pro Million Ausgabe-Token; prüfen Sie den aktuellen Preis in der Konsole. Gesammelt über die Batch API verarbeitete Anfragen kosten 60 % des Standardpreises.

Beherrscht Kimi K3.1 Pro Deutsch?

Die Modellkarte von Moonshot nennt keine unterstützten Sprachen, und das offizielle Beispiel beschreibt das Modell als besonders gut auf Chinesisch und Englisch. Testen Sie die Antwortqualität auf Deutsch mit echten Kundenfragen, bevor Sie live gehen, und legen Sie die Antwortsprache in der Systemanweisung fest.

Können wir Kimi K3.1 Pro auf eigenen Servern betreiben?

Die Gewichte liegen auf Hugging Face, und die Modellkarte nennt für vLLM den Befehl vllm serve "moonshotai/Kimi-K3.1-Pro". Mit insgesamt 2,8 Billionen Parametern braucht das Modell aber einen Multi-GPU-Server. Interne Nutzung ist laut Lizenz frei; wer das Modell anderen als Dienst anbieten will, prüft die Umsatzschwelle der Lizenz.

Können wir bestehenden OpenAI-Code auf Kimi K3.1 Pro umstellen?

Ja. Die Kimi API folgt dem OpenAI-Format, es genügt, Schlüssel, base_url und Modell-ID zu ändern. Entfernen Sie außerdem die festen Parameter (temperature, top_p) aus den Anfragen und schicken Sie in mehrstufigen Gesprächen die Assistentennachricht mit reasoning_content zurück.

←Zurück zum Blog