Kimi K3.1 Pro API Key 配置:5步接入与推理强度封面图
AI 编程约 9 分钟

Kimi K3.1 Pro API Key 配置:5步接入与推理强度

AI 指南··◉ 0 浏览

完整流程是 5 步,前 4 步在开放平台和终端里完成,第 5 步才写代码。前置条件只有两个:能登录 platform.kimi.com 的账号,以及 Python 3.9+ 或 Node.js 18+。要付费,K3.1 Pro 是旗舰模型,账户充值 10 元起才解锁调用,新用户那 15 元代金券用不了。

价格是每百万 token 输入 13 元、缓存命中 1.3 元、输出 68 元,高速版翻倍。

Kimi API 开放平台控制台首页与 API Keys 入口

第 1 步:拿到能用的 Key

登录 Kimi API 开放平台,进 API Keys 页面新建一个,复制下来。

Kimi K3.1 Pro 账户充值解锁与模型定价表

这一步最常见的翻车点不在点按钮,在账单。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 是你唯一的那档闸门。

Kimi K3.1 Pro reasoning_effort 三档与任务类型对应关系

三档怎么选,按任务类型分:

档位 适合什么 代价
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。长任务要配流式。

缓存能把输入价打到十分之一

Kimi K3.1 Pro 上下文缓存命中结构示意

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 算,三个工具会共用同一份额度。

评论 (0)

?
0/1

还没有评论,来发第一条吧

网站上的服务均为第三方提供,
请用户注意自行甄别。

北京酷讯互动科技有限公司

备案京ICP备2024094994号-29

© 2026 AI345 · All Rights Reserved

用户服务协议·隐私政策