Skip to main content

​
Moonshot 工作原理

Moonshot AI 发布 Kimi 系列模型(K2、K2.5、K2.6、K2.6 Coding)。Kimi 在长上下文代码理解和 Agent 型任务上表现尤为突出,其 API 完全兼容 OpenAI — Kodus 可以通过 OpenAI-compatible 提供商与之对接。Kodus 还提供专用的 Moonshot 提供商,它通过 Moonshot 的 Anthropic 兼容端点(https://api.moonshot.ai/anthropic)进行连接。 Moonshot 为同一模型系列提供两条路径,各自有独立端点:
  • 开发者 API(platform.moonshot.ai)— 按 token 付费,按用量计费。并发随充值档位伸缩。
  • Kimi Code Plan(kimi.com/code)— 带专用编码端点的订阅。统一定价,并发被封顶(30 并发)。
Moonshot 的消费者 Kimi.com 聊天订阅(Andante、Moderato 等)与上述两条 API 路径均无关。聊天订阅不授予 API 访问权限。Kimi Code Plan 才是针对 API 的订阅。
Moonshot 还运营一个仅限中国大陆的平台(platform.moonshot.cn,基础 URL 为 https://api.moonshot.cn/v1),以人民币计费。仅当您在中国大陆运营时使用。

​
方案概览

​
Kimi Code Plan(订阅)

​
开发者 API(按 token 付费)

开发者 API 端点:https://api.moonshot.ai/v1(国际版)。并发随充值档位伸缩 — Tier 1($10 充值)起始约 50 并发,Tier 5 最多约 1000 并发。

​
创建 API 密钥

创建 API 密钥需要 Moonshot 账号。
  1. 访问 kimi.com/code 并订阅该方案。
  2. 打开订阅的密钥管理区域。
  3. 创建 Kimi Code 密钥并复制。
Kimi Code 密钥仅适用于 https://api.kimi.com/coding/v1。发送到 api.moonshot.ai 会返回 401。

​
在 Kodus 中配置 Moonshot

主流程是使用 Kodus Cloud 上的 AI providers 页面。希望在进程层级固定提供商的自托管用户可以改用环境变量。

​
方式 1 — Kodus Cloud 上的 Moonshot 提供商(推荐用于开发者 API)

1

打开 AI providers 并选择 Moonshot

在侧边栏中打开 AI providers(app.kodus.io/byok)。在 Providers 选项卡上,点击 Moonshot 磁贴(位于 Connect your first provider 下;如果您已连接过提供商,则位于 Add another provider 下)。
2

粘贴您的 API 密钥并选择模型

在 API key 卡片中粘贴来自 platform.moonshot.ai 的开发者 API 密钥。随后 Model 选择器会加载 Moonshot 的模型 — 选择其中一个(例如 kimi-k2.6)或选择 Type model manually。Kodus 会为您填入 https://api.moonshot.ai/anthropic 端点;该磁贴没有方案选择器,也没有基础 URL 字段,因此对于 Kimi Code Plan 密钥(或中国平台),请使用下面的方式 2。
3

Test & save

点击 Test & save。Kodus 会测试连接,成功后保存配置。401 表示密钥与端点不匹配。

​
调优推理(可选)

Thinking / Reasoning 位于 Advanced (optional) 下。对于 Kimi,除 Off 以外的任何级别都会发出 thinking: { type: "enabled" }。如需覆盖,请将 Thinking / Reasoning 切换为 Custom 并粘贴以下任一配置:
  • 禁用 thinking,在小型 PR 上实现更快/更便宜的审查:
  • 强制特定 token 预算(如果 Moonshot 在您的档位支持 budget_tokens):
无需命名空间包装 — Kodus 在发送前会将选项包装在当前提供商的命名空间下。详见 主 BYOK 文档 → 自定义 JSON 覆盖。

​
调优并发

  • Kimi Code Plan:将 Max concurrent requests(位于 Advanced (optional) 下)设置为 30(文档上限)。更高会返回 429。
  • 开发者 API:保持为空(无上限)。实际限制随充值档位伸缩 — Tier 1(约 10充值)允许约50并发;Tier5(约10 充值)允许约 50 并发;Tier 5(约 3000)允许约 1000。如果审查时看到 429,请显式下调。
在 Routing 选项卡上,将 Kimi 设置为 Model for all tasks,并将一个 OpenAI 或 Anthropic 模型设置为 Fallback (optional) — 如果 Moonshot 返回 429 或 402,Kodus 会自动故障转移。

​
方式 2 — OpenAI 兼容端点

对于 Kimi Code Plan、中国平台或 Moonshot 的 OpenAI 兼容端点,请打开 AI providers,在 Providers 选项卡上选择 Custom 下的 OpenAI-compatible,并填写:

​
方式 3 — 自托管(环境变量)

如果您以 Fixed Mode 运行 Kodus(单一全局提供商,无按组织 BYOK),在 API + worker 容器的 .env 中配置 Moonshot:
仅在有意禁用 BYOK 的自托管 Kodus 安装中才需要这条路径。如果您的自托管实例启用了 BYOK,请优先使用方式 1或方式 2 — AI providers 页面的用法与 Cloud 上相同。
编辑 .env 后重启 API 和 worker 容器,然后验证集成:
完整的自托管设置(域名、安全密钥、数据库、webhook、反向代理)请参见通用 VM 部署指南,只需将 LLM 部分替换为上面的配置。

​
在 Kimi Code Plan、开发者 API 和聚合器之间选择

  • Kimi Code Plan — 可预测的统一月费、30 并发上限、专为编码工作流优化的专用 api.kimi.com/coding/v1 端点。适合 PR 流量稳定、团队常态化运行的场景。
  • Moonshot 开发者 API — 按 token 付费,并发随充值档位伸缩,灵活度最高。适合波动性负载。
  • OpenRouter 代理 — 如果您希望多个提供商统一结算,OpenRouter 以少量路由加价暴露 Kimi 模型。当 Kimi 是混合提供商矩阵中的一员、而不是主要工作负载时选择它。

​
故障排查

  • Kimi Code Plan 密钥仅在 api.kimi.com/coding/v1 上工作。
  • 来自 platform.moonshot.ai 的开发者 API 密钥仅在 api.moonshot.ai/v1 上工作。
  • 来自 platform.moonshot.cn 的开发者 API 密钥仅在 api.moonshot.cn/v1 上工作。
  • Moonshot 磁贴始终使用 https://api.moonshot.ai/anthropic,因此需要 platform.moonshot.ai 的密钥。Kimi Code Plan 或 platform.moonshot.cn 的密钥请通过 OpenAI-compatible 并配合相应的 Base URL 连接。
  • 开发者 API 按 token 付费。余额耗尽时请求返回 HTTP 402。
  • 在控制台的账单页面充值,或设置月度上限以避免超支。
  • Kimi Code Plan 虽然是统一定价,但受 30 并发上限和配额窗口约束 — 429 意味着您撞到了其中之一。
  • 确认模型名称与目录匹配(kimi-k2.6、kimi-k2.6、kimi-k2.5、kimi-k2-0905、kimi-k2)。
  • 请查看 platform.kimi.ai/docs 了解当前列表 — 新版本发布频繁。
  • 一段时间闲置后的首次调用可能在 Moonshot 侧冷启动。
  • 如果延迟重要,kimi-k2-0905 在常规审查上通常比 K2.6 变体更快。
  • 中国大陆以外的用户应始终使用 api.moonshot.ai 或 api.kimi.com。从大陆以外访问 api.moonshot.cn 可能不通或被限速。
  • 确认您的 Kodus 部署允许对所选端点的出站 HTTPS。

​
相关链接