
Kimi K3.1 Pro API Key 配置:5步接入与推理强度
完整流程是 5 步,前 4 步在开放平台和终端里完成,第 5 步才写代码。前置条件只有两个:能登录 platform.kimi.com 的账号,以及 Python 3.9+ 或 Node.js 18+。要付费,K3.1 Pro 是旗舰模型,账户充值 10 元起才解锁调用,新用户那 15 元代金券用不了。
价格是每百万 token 输入 13 元、缓存命中 1.3 元、输出 68 元,高速版翻倍。

第 1 步:拿到能用的 Key
登录 Kimi API 开放平台,进 API Keys 页面新建一个,复制下来。

这一步最常见的翻车点不在点按钮,在账单。K3.1 Pro 的模型介绍页写得很清楚:完成充值(最低 10 元)后才解锁调用,而且「新用户注册认证赠送的 15 元代金券不可用于 Kimi K3.1 Pro」。很多人注册完拿着 15 元去试,报的是权限类错误,其实是没充值。
另一个坑是累计充值金额同时决定账户等级和速率限制(并发、RPM、TPM、TPD)。新充值的账户跑单条请求没问题,跑批量脚本会撞限速。具体每档多少,官方充值与限速页的表格是动态渲染的,这里不编数字,自己进充值与限速看对应档位。
第 2 步:把 Key 放进环境变量
官方给的做法是环境变量,不要硬编码进代码:
export MOONSHOT_API_KEY="你的_KIMI_API_KEY"
三个提醒。第一,这行只对当前终端会话生效,要长期存就写进 ~/.zshrc,但那是明文,注意文件权限。第二,别把 Key 粘进源码、notebook、聊天窗口或截图,一旦进过 git 仓库就吊销重发。第三,用 Codex 或 Claude Code 这类工具时,环境变量名和上面这个不一样,见第 5 步。
第 3 步:认准 base_url 和模型 ID
两个值,写错任何一个都会报错:
- base_url:
https://api.moonshot.cn/v1 - 模型 ID:
kimi-k3.1-pro(高速版kimi-k3.1-pro-highspeed)
这里有个容易误会的地方。平台入口域名是 platform.kimi.com,但 API 端点官方示例一律写 api.moonshot.cn,两者是同一套服务,别自己改成 api.kimi.com。
模型 ID 也不能随便缩写。kimi-k3 是上一代旗舰,kimi-k3.1-pro 才是这次的;写 k3.1-pro 或 kimi-k3.1 都会报模型不存在。模型清单见模型列表。
| 写法 | 结果 |
|---|---|
kimi-k3.1-pro |
正确 |
kimi-k3.1-pro-highspeed |
正确,速度快 2 到 3 倍,价格 2 倍 |
kimi-k3 |
能跑,但是上一代模型 |
k3.1-pro / kimi-k3.1 |
报模型不存在 |
上下文窗口是 1,048,576 tokens。顺带说一句,K2 系列正在退场:10 月 31 日起不再向新注册用户开放,12 月底全部下线。老项目里写死 kimi-k2* 的这两天就该改。
第 4 步:发第一个请求
Python 用 OpenAI SDK,Kimi 兼容它的格式:
pip install --upgrade 'openai>=1.0'
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MOONSHOT_API_KEY"],
base_url="https://api.moonshot.cn/v1",
)
completion = client.chat.completions.create(
model="kimi-k3.1-pro",
messages=[{"role": "user", "content": "用一句话介绍 Kimi K3.1 Pro。"}],
)
print(completion.choices[0].message.content)
不想装 SDK 就直接 curl:
curl https://api.moonshot.cn/v1/chat/completions \
--header "Authorization: Bearer $MOONSHOT_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kimi-k3.1-pro",
"messages": [{"role": "user", "content": "用一句话介绍 Kimi K3.1 Pro。"}]
}'
返回体里会同时有 content 和 reasoning_content。K3.1 Pro 是始终开启思考的模型,reasoning_content 是思考过程,content 才是答案。想打印思考过程就取这个字段,别指望它会混进 content 里。
第 5 步:设推理强度,这一步决定账单
推理强度是 K3.1 Pro 接入里最容易搞错的一块,也是最能直接省钱的一块。
规则三条:字段名是请求顶层的 reasoning_effort;取值 low / high / max;默认 max。官方在推理强度文档里写得很明确,不做这个字段就是最高强度。
completion = client.chat.completions.create(
model="kimi-k3.1-pro",
messages=[{"role": "user", "content": "证明根号 2 是无理数。"}],
reasoning_effort="high",
)
必须知道的一个事实:思考模式关不掉。官方常见问题的原话是「目前关不了,K3.1 Pro 始终开启思考模式」,觉得思考太长只能把 reasoning_effort 调成 low。所以「省 token」这件事上,low 是你唯一的那档闸门。

三档怎么选,按任务类型分:
| 档位 | 适合什么 | 代价 |
|---|---|---|
max(默认) |
复杂重构、数学证明、多步 Agent 任务 | 思考 token 最多,最慢也最贵 |
high |
日常写代码、改 bug、需要一点推理的问答 | 折中 |
low |
改文案、格式化、分类抽取、简单问答 | 复杂任务效果会掉 |
不显式传这个字段,所有请求都按 max 计费。改个变量名这种活儿跑 max,是纯浪费。
同文档里还有几条「重要限制」,一起记住能少踩坑:temperature、top_p、n、presence_penalty、frequency_penalty 都是固定值,不要显式传;max_completion_tokens 默认 131072,最大可设 1048576;从 K2.x 迁过来的项目要把旧的 thinking 配置删掉。
推理强度在三个编程 Agent 里怎么填
Kimi Code CLI。 在项目目录执行 kimi,输入框里敲 /login,平台选 Kimi Platform (API key · platform.kimi.com),粘贴 Key,然后从列表里选模型。关键就在这一步:平台必须和 Key 的创建站点一致,选错平台校验直接失败。选完模型后 CLI 会保存配置,下次启动沿用,换 Key 也是再走一次 /login。用 /status 确认当前模型,再让它读一下项目目录结构,能返回就说明通了。官方文档见 Kimi Code CLI 接入。
Codex。 环境变量名是 KIMI_API_KEY(不是 MOONSHOT_API_KEY),Key 不要写进 config.toml。然后编辑 ~/.codex/config.toml:
model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576
[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.cn/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"
wire_api = "responses" 是走 Responses API 直连的关键配置,缺了它连不上。model_context_window 不配会用 Codex 的默认元数据,长任务表现会打折。详见在 Codex 中使用 Kimi K3.1 Pro。
Claude Code。 走 Anthropic 兼容格式,base_url 换成 https://api.moonshot.cn/anthropic,配置写在 ~/.claude/settings.json 的 env 字段里。这里提醒一句,settings.json 会覆盖终端里 export 的同名变量,之前手动改过配置的,先清理掉 ANTHROPIC_* 残留,否则新配置静默不生效。
常见报错速查
| 现象 | 原因 | 解法 |
|---|---|---|
| 401 | Key 没读到、复制带空格、已撤销 | 确认环境变量在当前 shell 生效,回控制台重建 Key |
| 模型不存在 | 模型 ID 写错,或账户没充值解锁 | 用 kimi-k3.1-pro,确认已充值 10 元以上 |
| 429 | 撞速率限制或额度 | 看充值与限速页的账户档位,降并发 |
| 504 | 单请求超过 2 小时超时 | 拆任务,或改流式输出 |
| 思考内容长但答案短 | 默认 max 档 | 显式传 reasoning_effort 降档 |
| Claude Code 改了配置没反应 | settings.json 覆盖了 shell 变量 |
清掉重复的 ANTHROPIC_* |
| 公网图片 URL 报错 | 视觉输入不支持公网 URL | 用 base64 或 ms://<file-id> |
504 这条来自官方主要概念:单请求超时上限 2 小时,超了返回 504。长任务要配流式。
缓存能把输入价打到十分之一

K3.1 Pro 的缓存是自动生效的,不需要手动创建,只要请求前缀相同就会命中。命中价 1.3 元,未命中 13 元,差 10 倍。
代价是多了一项缓存写入费,5m 和 1h 两档 TTL 分别计费。默认 5m,请求间隔可能超过 5 分钟的(长会话、有人工介入的 Agent)传 prompt_cache_options 选 1h:
"prompt_cache_options": {"mode": "implicit", "ttl": "1h"}
提高命中率的做法就三条:稳定的 system prompt、工具定义、参考资料放请求最前面;每轮变化的内容放后面;前缀里别塞时间戳或随机 ID,一处变动后面全部失效。想验证效果,控制台有 Caching 概览页可以看命中率。
顺手补一个省钱选项:kimi-k3.1-pro 支持 Batch API,费用是标准价的 60%,适合不赶时间的批量任务。
接上之后值得延伸的几篇
版本没选定的先看站内 Kimi K3.1 Pro 高速版和标准版区别,那篇把价格翻倍和速度提升放在一起算了账,判断标准只有一条:等待时间是你自己盯着,还是挂着跑别的活。
把 K3.1 Pro 接进 Codex 会碰到另一套配置字段,站内 Codex CLI API Key 配置 专讲 auth.json 和 401 那六个成因,这篇第 5 步的 Codex 段落只够起步。
要走 Anthropic 兼容格式接 Claude Code 的,站内 Claude Haiku 5.5 API Key 配置教程 里清理 ANTHROPIC_* 残留的流程完全通用。
最后补一个账号侧的坑:Kimi 的会员额度和 API 余额是两套账,会员那边撞额度会在终端里报 429,站内 Claude Max 429 额度用完怎么解决 里「看提示有没有给重置时间」的判定法,换个产品也照样能用。
常见问题
Kimi K3.1 Pro 的 API Key 在哪里获取
登录 platform.kimi.com,进控制台的 API Keys 页面创建并复制。注意创建 Key 不等于能调用旗舰模型,K3.1 Pro 需要账户累计充值满 10 元才解锁,新用户的 15 元代金券不能用于这个模型。
Kimi K3.1 Pro 的 base_url 是 api.kimi.com 还是 api.moonshot.cn
官方示例统一用 `https://api.moonshot.cn/v1`。平台入口是 platform.kimi.com,调用端点是 api.moonshot.cn,两个域名属于同一套服务,不要自己改成 api.kimi.com。走 Anthropic 兼容格式时端点换成 `https://api.moonshot.cn/anthropic`。
Kimi K3.1 Pro 的思考模式怎么关
关不了。官方常见问题里明确写了 K3.1 Pro 始终开启思考模式,目前没有关闭开关。觉得思考太长只能把 `reasoning_effort` 从默认的 `max` 降到 `low`,这是唯一的调节手段。
reasoning_effort 不传会怎样
按 `max` 处理。官方文档写的默认值就是 `max`,也就是说你不显式传 `low` 或 `high`,每个请求都按最高强度思考并计费。改个变量名、格式化文本这类活也跑 max,账单会明显偏高。
Kimi K3.1 Pro 的 API 免费吗
不免费,按量计费,也没有订阅制方案。价格是每百万 token 输入 13 元、缓存命中 1.3 元、输出 68 元,高速版各项翻倍。要省钱可以走 Batch API(标准价 60%),或者把推理强度降到 `low`。
一个 Key 能同时给 Kimi Code、Codex、Claude Code 用吗
能。同一个 Key 是账户级的,三个工具填的字段不同但来源一样:Kimi Code 用 `/login` 粘进去,Codex 读 `KIMI_API_KEY` 环境变量,Claude Code 填 `ANTHROPIC_AUTH_TOKEN`。速率限制按用户账户算,不按 Key 算,三个工具会共用同一份额度。

京ICP备2024094994号-29