Kimi K3.1 Pro verwenden: Anleitung

So verwendest du Kimi K3.1 Pro auf vier Wegen: Chatte damit in der Kimi-Web- oder Mobile-App, rufe kimi-k3.1-pro über die OpenAI-kompatible API unter https://api.moonshot.ai/v1 auf, führe es in der Kimi Code CLI mit einer kostenpflichtigen Mitgliedschaft aus oder richte Codex, Claude Code oder OpenCode auf Moonshots Endpunkte aus. Die API wird nach einer Aufladung von 1 $ freigeschaltet und kostet 2 $ pro Million Eingabe-Tokens und 10 $ pro Million Ausgabe-Tokens.

Moonshot AI hat Kimi K3.1 Pro am 23. Oktober 2026 veröffentlicht. Es ist eine nachtrainierte Version von Kimi K3 mit demselben MoE-Design mit 2,8 Billionen Parametern (etwa 104 Mrd. aktiv), einem Kontextfenster von 1.048.576 Tokens und immer eingeschaltetem Denken. Wenn du zuerst den Hintergrund möchtest, lies was Kimi K3.1 Pro ist. Wenn du nichts ausgeben möchtest, deckt unser Leitfaden zur kostenlosen Nutzung von Kimi K3.1 Pro die 0-$-Wege ab. Jede Tatsache unten stammt aus Moonshots Ankündigung, API-Quickstart und Preisseite, gelesen am 24. Oktober 2026.

Welchen Weg für Kimi K3.1 Pro solltest du wählen?

Wähle danach, was du baust. Chat eignet sich für schnelle Fragen, die API für Apps, Kimi Code für Mitglieder, die einen Agenten ohne zu verwaltenden Schlüssel möchten, und dein eigener Agent für Teams, die bereits in Codex oder Claude Code leben.

Kimi K3.1 Pro in den Kimi-Web- und Mobile-Apps verwenden

Die Chat-Apps sind der schnellste Einstieg. Öffne die Kimi-Web-App oder die iOS-, Android- oder HarmonyOS-App, melde dich mit einem kostenlosen Konto an, und K3.1 Pro ist im Composer bereits das Standardmodell, mit Denkaufwand auf High gesetzt.

Vor der Anmeldung listet der Composer außerdem K2.8 Preview und Instant auf. Zum Senden eines Prompts ist ein Konto erforderlich. Moonshot veröffentlicht das Nachrichtenkontingent für K3.1 Pro im kostenlosen Tarif nicht [PRÜFEN], behandle den Chat daher als Testumgebung, nicht als Produktionskanal.

Kimi Work Desktop 3.1.0 und neuer (Windows und Apple-Silicon-Macs) führt das Modell ebenfalls aus. In Kimi Business und Enterprise muss ein Admin es aktivieren, da es beim Start standardmäßig deaktiviert ist.

Kimi K3.1 Pro API: erster Aufruf in Python und cURL

Die Kimi K3.1 Pro API ist OpenAI-kompatibel, daher funktioniert das Standard-openai-SDK mit geänderter Basis-URL. Die Einrichtung umfasst drei Schritte:

1. Lade mindestens 1 $ auf. K3.1 Pro ist ein Flaggschiffmodell und wird erst nach einer erfolgreichen Aufladung freigeschaltet.
2. Erstelle einen Schlüssel in der API-Schlüssel-Konsole und exportiere ihn als MOONSHOT_API_KEY.
3. Rufe das Modell kimi-k3.1-pro (oder kimi-k3.1-pro-highspeed) unter https://api.moonshot.ai/v1 auf.

Hier ist Moonshots offizielles Python-Beispiel:

import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["MOONSHOT_API_KEY"], base_url="https://api.moonshot.ai/v1")
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}],
)
print(completion.choices[0].message.content)

Derselbe Aufruf in cURL:

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","reasoning_effort": "high","messages": [{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}]}'

Das Modell akzeptiert Text, Bilder und Videos als Eingabe (der Quickstart zeigt image_url- und video_url-Teile) und gibt Text zurück. Du kannst Prompts auch im Playground ausprobieren, bevor du Code schreibst. Für Muster aus der K3-Ära, die weiterhin gelten, siehe unseren Kimi K3 API-Leitfaden.

Kimi K3.1 Pro Reasoning-Aufwand: low, high oder max

reasoning_effort ist ein Anfragefeld auf oberster Ebene, das festlegt, wie viel das Modell nachdenkt, bevor es antwortet. Es akzeptiert "low", "high" und "max", Standard ist "max". Das Denken kann nicht deaktiviert werden. Es gibt keine Stufe "medium".

Moonshots Reasoning-Effort-Leitfaden enthält die vollständige Referenz. Da du Ausgabe-Tokens mit 10 $ pro Million bezahlst, ist der Wechsel von max auf low bei einfachen Aufrufen die einfachste Einsparung, die du finden wirst. Lass temperature und top_p weg: Der Quickstart listet sie als fest auf 1,0 und 0,95.

Reasoning streamen, Multi-Turn-Zustand beibehalten, JSON zurückbekommen

Drei API-Verhaltensweisen sorgen für Stolperfallen, und jede hat eine einfache Regel.

Streaming. Eine gestreamte Antwort sendet getrennte reasoning_content- und content-Deltas. Zeige oder protokolliere das erste, rendere das zweite:

stream = client.chat.completions.create(
    model="kimi-k3.1-pro", reasoning_effort="low", stream=True,
    messages=[{"role": "user", "content": "Explain MoE routing briefly."}],
)
for chunk in stream:
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="")
    if delta.content:
        print(delta.content, end="")

Multi-Turn und Tool-Aufrufe. Sende die vollständige Assistant-Nachricht zurück, nicht nur ihren content. Moonshots Dokumentation ist diesbezüglich eindeutig, und es ist am wichtigsten, wenn Tool-Aufrufe im Spiel sind:

messages.append(completion.choices[0].message)  # whole message, not .content
messages.append({"role": "user", "content": "Now add tests."})

tool_choice: "required" wird unterstützt, wenn das Modell ein Tool aufrufen soll. Der Partial-Modus funktioniert ebenfalls: Beende deine Nachrichten mit einer Assistant-Nachricht, die "partial": true enthält, und das Modell setzt sie fort.

Strukturierte Ausgabe. Übergib response_format mit Typ json_schema und strict: true und parse dann nur message.content. Parse niemals den Reasoning-Text.

Kimi Code K3.1 Pro: der Mitgliedschaftsweg

Kimi Code ist Moonshots eigener Terminal-Coding-Agent und der Weg ohne API-Schlüssel. Stattdessen meldest du dich mit deinem Kimi-Konto an. Es ist ein Mitgliedschaftsvorteil, daher ist es im kostenlosen Adagio-Tarif nicht enthalten.

Installiere es und melde dich an:

# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
# Windows PowerShell: irm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi

Führe in der Sitzung /login aus, dann /model, um K3.1 Pro auszuwählen. Die beiden IDs entsprechen Tarifstufen:

• k3.1-pro: Moderato (Plus) und höher. Allegretto (Pro) und höher schalten bis zu 1 M Kontext frei.
• k3.1-pro-highspeed: Allegretto (Pro) und höher, verbraucht etwa 2x Kontingent.

Laut Mitgliedschaftspreisen kostet Plus 15 $ pro Monat bei jährlicher Abrechnung (19 $ monatlich) und Pro 31 $ jährlich (39 $ monatlich). Die Kimi Code-Dokumentation behandelt die Befehle, und unsere Kimi Code CLI-Schritt-für-Schritt-Anleitung geht tiefer auf die tägliche Nutzung ein.

Kimi K3.1 Pro in Codex

Codex kommuniziert über die Responses API mit Kimi, und Moonshot veröffentlicht einen offiziellen Codex-Leitfaden. Füge dies zu ~/.codex/config.toml hinzu:

model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576

[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

Beachte den Namen der Umgebungsvariable: Codex liest KIMI_API_KEY, nicht MOONSHOT_API_KEY. Exportiere deinen Moonshot-Schlüssel unter diesem Namen und starte dann codex wie gewohnt.

Kimi K3.1 Pro in Claude Code

Moonshot betreibt einen Anthropic-kompatiblen Messages-Endpunkt unter https://api.moonshot.ai/anthropic, daher funktioniert Claude Code ohne Proxy. Setze die Variablen in den env-Block von ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]"
  }
}

Der Alias ist absichtlich so. Moonshots Fehlerbehebungsseite sagt, dass direkte API-Aufrufe und Codex kimi-k3.1-pro verwenden, während Claude Code den kompatiblen Alias kimi-k3[1m] nutzt. Der Claude Code-Leitfaden setzt auch die anderen Modellvariablen, also übernimm diese von dort.

Ein Stolperstein: Veraltete Werte im env-Block der Einstellungsdatei überschreiben Shell-Exporte. Wenn Claude Code weiterhin ein altes Modell aufruft, prüfe zuerst diese Datei.

OpenCode

OpenCode benötigt keine Konfigurationsdatei. Führe opencode auth login aus, wähle „Moonshot AI“, füge deinen Schlüssel ein und wähle dann K3.1 Pro aus den Moonshot AI-Modellen. Moonshots OpenCode-Leitfaden wurde für K3 geschrieben, bestätige daher, dass das Modell in deiner Liste erscheint [PRÜFEN].

Lass deinen Agenten die Kimi API mit Apidog CLI testen

Sobald Codex oder Claude Code auf K3.1 Pro läuft, setze dieselbe Sitzung für Regressionstests der Kimi API selbst ein. Dein Agent schreibt und führt die Prüfungen aus; du schreibst einen Prompt. Apidog CLI liefert strukturierte JSON-Ausgabe und Schemas, damit er keine Payload-Formen errät.

Installiere die CLI, melde dich an und füge die Agent-Skill hinzu:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
apidog skill install

Gib deinem Agenten dann einen Prompt:

In Apidog project <projectId>, create an environment for https://api.moonshot.ai/v1.
Then create a test case for POST /chat/completions with model kimi-k3.1-pro and
reasoning_effort "low" that asserts status 200 and non-empty choices[0].message.content.
Run it and summarize any failures.

Der Agent erstellt die Umgebung, liest das Schema, validiert seine Payload, schreibt den Testfall und führt ihn aus:

apidog environment create kimi-prod --project <projectId> --base-url https://api.moonshot.ai/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Testfälle benötigen eine gültige Kategorie, und apidog test-case category --project <projectId> listet sie auf. Ein 200 mit einer nicht leeren Antwort beweist außerdem, dass die API reasoning_effort akzeptiert hat. Ersetze es durch -r junit, und derselbe Lauf lässt sich in CI integrieren, wie unser Apidog CLI CI/CD-Leitfaden zeigt. Agentspezifische Einrichtung findest du in Apidog CLI in Codex und Apidog CLI in Claude Code. Der kostenlose Tarif von Apidog deckt bis zu 4 Benutzer ab.

Kimi K3.1 Pro Kostenhinweise

Die API wird nach Verbrauch abgerechnet, ohne Abonnement, und die Preise verstehen sich ohne Steuern.

K3.1 Pro ist bei Eingabe und Ausgabe ein Drittel günstiger als K3. Caching erfolgt automatisch für wiederholte Präfixe, mit einer standardmäßigen TTL von 5 Minuten, und Cache-Treffer werden mit 0,20 $ abgerechnet. Highspeed läuft 2-3x schneller zum doppelten Preis.

Deine Mindestaufladung von 1 $ kauft etwa 500K Eingabe-Tokens oder 100K Ausgabe-Tokens. Wenn deine kumulativen Aufladungen 5 $ erreichen, erhältst du einen 5-$-Gutschein, aber Gutscheine zählen nicht zur kumulativen Aufladung, und ob sie für K3.1 Pro gelten, wird nicht angegeben [PRÜFEN]. Ein 1-$-Konto startet in Tier0 auf der Limits-Seite: 1 gleichzeitige Anfrage, 3 RPM und 1,5 M Tokens pro Tag. Tier1 bei 10 $ kumulativ hebt das auf 100 RPM an.

FAQ

Sind die Gewichte von Kimi K3.1 Pro offen?

Noch nicht. Moonshot sagt, dass die vollständigen Modellgewichte bis zum 4. November 2026 veröffentlicht werden. Die Lizenz wurde nicht genannt.

Was ist der Unterschied zwischen K3.1 Pro und K3.1 Pro Highspeed?

Dieselbe Modellfamilie, andere Geschwindigkeit und anderer Preis. Highspeed läuft 2-3x schneller und kostet 4 $/20 $ pro Million Tokens gegenüber 2 $/10 $. In Kimi Code erfordert es den Pro-Tarif und verbraucht etwa 2x Kontingent.

Kann ich das Denken in Kimi K3.1 Pro deaktivieren?

Nein. Das Denken ist immer aktiviert. Setze reasoning_effort auf "low", um Reasoning-Tokens und Latenz zu reduzieren.

Warum bricht mein Multi-Turn-Gespräch ab?

Du sendest wahrscheinlich nur den content der Assistant-Nachricht zurück. Hänge das vollständige Assistant-Nachrichtenobjekt an deinen Verlauf an, wie es Moonshots Dokumentation für Multi-Turn-Chats und Tool-Aufrufe verlangt.

Ist die Kimi API kostenlos?

Nein. K3.1 Pro wird nach einer Mindestaufladung von 1 $ freigeschaltet. Der kostenlose Chat in der Kimi-App ist die 0-$-Option, die in unserem kostenlosen Leitfaden behandelt wird.

Unterstützt Kimi K3.1 Pro ein 1M-Kontextfenster?

Ja. Die API unterstützt 1.048.576 Tokens. In Kimi Code erfordert der volle 1M-Kontext Allegretto (Pro) oder höher.