上周三 Kimi K3 开源的消息刷屏 HN1164 分我当天下午就跑通了 API 调用。结论先放这接入 Kimi K3 只需要改三个值——base_url设为https://api.moonshot.cn/v1、model填kimi-k3官方直连或聚合平台对应的 model ID各平台格式请以其控制台为准、api_key换成你的 Moonshot Key。整个过程 5 分钟不需要学新 SDKOpenAI 兼容格式一把梭。这篇把从注册 Key 到接入 Claude Code、Cline 的完整配置都写了包括和上一代kimi-k2.7-code的接入差异、6 个常见报错的排查方法。折腾半天不如直接抄配置。这篇适合谁想第一时间试 Kimi K3 但不确定 model ID 到底怎么填的开发者已经在用 Claude Code / Cline 写代码想加一个国产模型备选的之前接过 kimi-k2.7-code想知道 K3 接入有什么变化团队里需要统一管理多模型 API Key 和用量的技术负责人整体流程graph LR A[1.注册 Moonshot 账号] -- B[2.创建 API Key] B -- C[3.选接入方式] C -- D[官方直连] C -- E[聚合网关] D -- F[4.配置 base_url model] E -- F F -- G[5.首次调用验证] G -- H[6.接入 IDE 工具]注册 Moonshot 平台账号创建 API Key选择接入方式官方直连 or 聚合网关配置 base_url model ID跑通首次调用接入 Claude Code / Cline / Cherry StudioK3 vs K2.7-code 接入差异对比项kimi-k2.7-codekimi-k3官方 model IDkimi-k2.7-codekimi-k3聚合平台 model IDmoonshotai/kimi-k2.7-code以各平台实际列表为准moonshotai/kimi-k3以各平台实际列表为准架构未公开MoE混合专家官方公开信息官方 base_urlhttps://api.moonshot.cn/v1同左没变流式输出支持支持接口格式OpenAI 兼容同左没变接入层面的变化主要就是 model 字段换个名字。MoE 架构是推理侧的实现对调用方的代码逻辑没有影响。第一步注册并获取 API Key去platform.moonshot.cn注册账号进控制台左侧找「API Keys」点创建。拿到的 Key 长这样sk- 开头sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx记下来页面关了就看不到了。我第一次就忘复制了又得重新建一个。第二步官方直连——Python SDK 调用装 openai 库如果没装的话pip install openai1.0.0最简调用5 行搞定from openai import OpenAI client OpenAI( api_keysk-你的key, base_urlhttps://api.moonshot.cn/v1 )发请求resp client.chat.completions.create( modelkimi-k3, messages[{role: user, content: 你好}] ) print(resp.choices[0].message.content)流式输出版本打字机效果stream client.chat.completions.create( modelkimi-k3, messages[{role: user, content: 写一首诗}], streamTrue ) for chunk in stream: print(chunk.choices[0].delta.content or , end)第三步通过聚合网关接入如果你团队里同时用着 Claude、GPT、Kimi 好几个模型每个都单独管 Key 挺累的。聚合 API 网关可以选 OpenRouter、ofox.io 这类——改一个 base_url 就能切不同模型OpenRouter 收 5.5% 手续费ofox 是 0% 加价对齐官方价格。通过 ofox.io 调用 K3 的配置client OpenAI( api_key你的ofox-key, base_urlhttps://api.ofox.io/v1 )model 字段填聚合平台的完整 model ID请以 ofox.io 控制台实际模型列表为准OpenRouter 通常采用moonshotai/kimi-k3格式resp client.chat.completions.create( modelkimi-k3, # OpenRouter 格式ofox.io 请以控制台列表为准 messages[{role: user, content: 你好}] )官方直连和聚合网关的主要区别是 base_url 和 model ID 格式不同其他代码完全一样。第四步接入 Claude Code注意以下配置字段名基于社区实践整理Claude Code 的配置方式随版本可能有所变化字段名以你所用版本的官方文档为准。建议在操作前确认 Claude Code 版本是否支持自定义 provider 功能。在 Claude Code 的配置文件里设置自定义 provider。编辑~/.claude/settings.json字段名请以实际版本为准{ apiProvider: custom, customApiUrl: https://api.ofox.io/v1, customApiKey: 你的key, customModel: moonshotai/kimi-k3 }保存后重启 Claude Code在模型选择里就能看到 K3 了。一开始我把 model 写成了moonshot/kimi-k3少了 ai报了 400查了两分钟才发现。第五步接入 ClineCline 的配置更直观在 VS Code 里打开 Cline 设置面板API Provider: 选OpenAI CompatibleBase URL:https://api.moonshot.cn/v1官方直连或https://api.ofox.io/v1聚合网关API Key: 对应的 keyModel ID:kimi-k3直连或聚合平台对应 ID以控制台实际列表为准配完点 Test Connection绿勾就说明通了。第六步接入 Cherry StudioCherry Studio 里添加自定义模型源名称: 随便填比如Kimi K3接口地址:https://api.moonshot.cn/v1密钥: 你的 Moonshot API Key模型: 手动输入kimi-k3不同场景怎么选你的情况推荐接入方式原因个人开发者只用 K3官方直连最简单没有中间层同时用 Claude GPT Kimi聚合网关ofox.io / OpenRouter一个 Key 管所有不用到处切团队 10 人共用聚合网关 管理后台需要按人/按模型看用量和费用网络环境不稳定聚合网关多容灾比单点直连稳想用 K2.7-code 高速版官方直连model 填kimi-k2.7-code-highspeed请以 platform.moonshot.cn 控制台实际模型列表为准踩坑记录完整报错对照表报错信息原因解法401 Unauthorized - Invalid API key providedKey 错了或过期了去 platform.moonshot.cn 重新复制 Key确认 Header 格式是Bearer sk-xxx400 Bad Request - model not foundmodel ID 拼错或控制台实际名称与文档有出入检查是不是写成了kimi_k3下划线或kimik3没连字符正确的是kimi-k3如仍报错去 platform.moonshot.cn 控制台模型列表直接复制名称429 Too Many Requests - Rate limit exceeded请求太频繁触发限速加 retry exponential backoff或升级套餐额度ConnectionError: Max retries exceeded (hostapi.moonshot.cn)网络不通或 DNS 解析失败检查网络环境可用以下命令测试连通性需替换为你的实际 Keycurl https://api.moonshot.cn/v1/chat/completions -H Authorization: Bearer sk-你的key -H Content-Type: application/json -d {model:kimi-k3,messages:[{role:user,content:hi}]}400 Bad Request - context length exceeded输入太长超了上下文窗口截断输入或用 K3 的长上下文版本如有500 Internal Server Error服务端临时故障等几分钟重试不是你的问题。发布初期偶尔会有我上周五晚上就碰到了 500大概持续了 10 分钟恢复了。新模型刚上线正常。常见问题 FAQQ: Kimi K3 的 model ID 到底填什么网上说法不一样。A: 官方直连填kimi-k3。通过聚合平台接入时model ID 格式因平台而异OpenRouter 通常为moonshotai/kimi-k3其他平台请以各自控制台的实际模型列表为准。发布初期如果报 model not found去 platform.moonshot.cn 控制台的模型列表页确认一下实际名称直接复制粘贴最保险。主文中的5 分钟搞定是基于 model ID 已确认的情况实际操作前建议先核对控制台列表。Q: base_url 末尾要不要加斜杠/A: 不要加。写https://api.moonshot.cn/v1就行加了/反而可能拼接出v1//chat/completions这种双斜杠路径导致 404。Q: 已经有 OpenAI 的代码最快怎么切到 K3A: 改三处①base_url→https://api.moonshot.cn/v1②api_key→ 你的 Moonshot Key③model→kimi-k3。其余代码一行不用动连 response 结构都一样。Q: K3 支持 Function Calling 吗A: 官方文档暂未明确标注 K3 的 Function Calling 支持情况。个人测试时传了 tools 参数未报错但未报错不等于功能完整可用返回质量也未经充分验证。建议以官方文档的最新说明为准关注 platform.moonshot.cn 的更新公告。Q: K3 的价格是多少A: 截至 2026 年 7 月 3 日官方计费页面尚未公布 K3 的具体定价可能还在免费公测阶段。请以 platform.moonshot.cn 计费页面的最新信息为准我也不确定目前是不是限时免费。Q: 多个 IDE 工具能共用一个 Key 吗A: 可以。一个 Moonshot API Key 可以同时在 Claude Code、Cline、Cherry Studio 里配置不冲突。但要注意共享限速额度——如果一个工具跑满了 RPM另一个也会 429。小结K3 的接入体验和 K2.7-code 基本一致OpenAI 兼容格式的好处就是换模型成本极低。MoE 架构在推理效率上有其理论优势个人体验上感觉响应比 K2.7-code 快一些但没有做严格的延迟基准测试仅供参考。如果你只是想快速试一下5 行 Python 代码就够了。如果团队里多人多模型混用走聚合网关省心很多每个人的调用量和花费一目了然月底不用互相对账。
