Kimi K3.1 Pro API
Available NewKimi K3.1 Pro is the newest and largest model of Moonshot AI's Kimi family. On our 2026-11-18 check it answered an arithmetic question correctly with and without thinking, filled a tool call, returned valid JSON in JSON mode, and streamed at about 60 tokens per second with a first token in about half a second. Thinking is on by default and comes back in a reasoning_content field; reasoning_effort "none" switches it off. It runs on serverless GPUs in the United States.
Quickstart
Set INFERENCE_API_KEY to your key from the API Keys page, then run:
curl https://api.inferenceapis.com/v1/chat/completions \
-H "Authorization: Bearer $INFERENCE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "moonshotai/Kimi-K3.1-Pro",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello! What can you do?"}
]
}'
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.inferenceapis.com/v1",
api_key=os.environ["INFERENCE_API_KEY"],
)
response = client.chat.completions.create(
model="moonshotai/Kimi-K3.1-Pro",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello! What can you do?"},
],
)
print(response.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.inferenceapis.com/v1",
apiKey: process.env.INFERENCE_API_KEY,
});
const response = await client.chat.completions.create({
model: "moonshotai/Kimi-K3.1-Pro",
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "Hello! What can you do?" },
],
});
console.log(response.choices[0].message.content);
When to use it
- Long agent runs and repository-scale coding where a 1M-token window and a strong model matter more than price
- You used moonshotai/kimi-k2-instruct on Groq and want the current flagship rather than the coding variant
- Short, high-volume calls: it is the most expensive chat model here
- A person is waiting and thinking is on; switch it off or use Kimi K2.7 Code
What it costs in practice
| Workload | Cost |
|---|---|
| Chat assistant — 10,000 turns of 800 tokens in, 300 out | $59.80 |
| Long prompts or RAG — 10,000 requests of 8,000 in, 500 out | $273 |
| Generation-heavy — 10,000 requests of 500 in, 2,000 out | $273 |
Computed from the live rates below. This is a reasoning model, and thinking is billed as output, so real output counts run above the visible answer; see controlling reasoning to keep that down. There is no subscription or minimum; new accounts start with free credit.
Endpoint
Content-Type: application/json
/openai/v1/… is accepted too, so Groq-style base URLs work with only the host changed.
Model IDs and aliases
Send any of these as model; they all resolve to this model and bill at its rate.
| ID | Note |
|---|---|
moonshotai/Kimi-K3.1-Pro | Canonical |
kimi-k3.1-pro | Alias |
kimi-k3.1 | Alias |
Request body
| Parameter | Type | Description |
|---|---|---|
model required |
string | Model ID: moonshotai/Kimi-K3.1-Pro — also accepted: kimi-k3.1-pro, kimi-k3.1 |
messages required |
array | Conversation so far. Each item has a role (system, user or assistant) and content. |
max_tokens |
integer | Maximum number of tokens to generate (includes reasoning tokens — use a few hundred or more). |
temperature |
number | Sampling temperature. Higher values give more varied output. |
top_p |
number | Nucleus sampling cutoff. |
stream |
boolean | Stream the response as server-sent events. The final chunk includes usage. |
tools |
array | Tool definitions for function calling (OpenAI format). |
response_format |
object | {"type": "json_object"} for JSON mode. |
stop |
string | array | Sequences where the model stops generating. |
seed |
integer | Seed for more reproducible sampling. |
Response
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"model": "moonshotai/Kimi-K3.1-Pro",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hi! I can answer questions, write and edit text, help with code and more.",
"reasoning": "The user is greeting me and asking about capabilities..."
},
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 28, "completion_tokens": 17, "total_tokens": 45 }
}
Controlling reasoning
Send reasoning_effort: "none" to switch thinking off. Model families disagree on the parameter for this, and the wrong one is silently ignored, so the gateway accepts one spelling on every model (also "minimal", reasoning: {"enabled": false} and thinking: {"type": "disabled"}) and sends the switch this model honours; the X-Thinking: off response header confirms it. On the Responses API use reasoning: {"effort": "minimal"}. Leave thinking on for multi-step coding and maths; turn it off for extraction, classification, routing and chat. All models compared.
resp = client.chat.completions.create(
model="moonshotai/Kimi-K3.1-Pro",
reasoning_effort="none", # thinking off; omit it to let the model reason
messages=[{"role": "user", "content": "Extract the invoice number from: ..."}],
max_tokens=500,
)
print(resp.choices[0].message.content)Token counts are single measurements from September 17, 2026 and vary with the question; the direction is what matters.
Pricing
| Input | $2.60 / 1M tokens |
| Cached input | $0.26 / 1M tokens |
| Output | $13.00 / 1M tokens |
| Billing | Pay as you go from prepaid credits. No subscription, no daily request or token cap. See all pricing. |
Notes
- Priced at $2.60 input / $13.00 output per million tokens, with cached input at $0.26: ten times GPT-OSS 120B. Use it where the model quality pays for itself, and set per-key spend limits if agents will call it unattended.
- Groq's retired kimi-k2-instruct ids are aliases for Kimi K2.7 Code, not this model; send this id explicitly.
Compare Kimi K3.1 Pro with…
Errors
Errors use the OpenAI envelope: {"error": {"message", "type", "code"}}. 401 missing or invalid key · 402 insufficient_balance · 404 model_not_found · 503 model_unavailable · 502 backend error, safe to retry. Full table with what to retry: API documentation. Errors from other providers: provider error reference.
