很多开发者搜索“Moonshot API Key”，打开 platform.moonshot.cn 却发现跳到了另一个域名，于是怀疑自己找错了站。其实平台品牌做了调整：Moonshot 是公司与开放平台品牌，Kimi 是模型品牌，API 请求域名仍然保留 moonshot。本文按 2026 年的实际入口，讲清账号层级、Key 权限、存储、轮换和 401 排查。

说明：Moonshot、Kimi 是其权利人的商标，本文仅作技术接入说明。平台入口、认证要求和 Key 管理规则可能调整，请以控制台当前页面为准。

一、Moonshot 开放平台现在从哪里进

platform.moonshot.cn 目前会跳转到 platform.kimi.com，国际站 platform.moonshot.ai 跳转到 platform.kimi.ai。控制台、账号、余额和 Key 都在 Kimi API 开放平台里管理。

但 API 请求域名没有变：中国站仍是 api.moonshot.cn，国际站仍是 api.moonshot.ai。有些旧教程只换了控制台截图，没有解释这一点，才让人以为平台消失了。

记住三层关系：Moonshot 是平台品牌，Kimi 是模型品牌，api.moonshot.* 是接口域名。三者不是三套账号。中国站与国际站的账号、余额、Key 相互隔离，Key 与站点必须配套。

二、先选主体：未认证、个人还是企业

认证状态 最多项目 最多 API Key 适合场景
未认证 1 10 短期试用
个人认证 20 50 个人开发、小团队
企业认证 50 100 多项目、多成员

以上数字来自当前文档，控制台可能调整。企业认证后可以邀请成员、按项目分配权限并开票；个人认证不能邀请成员。认证主体变更规则以控制台为准，注册前先确定用个人还是企业主体，后续改主体往往牵涉合同和发票。

组织层还有 IP 白名单，个人和企业认证组织可用。它按组织生效，一次限制组织下所有 Key，最多 20 条公网 IPv4 地址或 CIDR，不接受 IPv6 和私网地址。每次保存会覆盖整个列表，出口 IP 不固定时不要贸然开启。

三、创建 Key 的正确顺序

  1. 登录 platform.kimi.com，进入控制台。
  2. 先建项目，按业务线或环境命名，例如 crm-prod、crm-test。
  3. 打开 API Keys 页面，创建 Key，名称包含项目、环境和用途。
  4. 复制 Key；若页面只展示一次，当场存入密钥管理器。
  5. 用 GET /v1/models 或一条最小请求验证 Key 与站点。
  6. 记录负责人、所属项目、创建时间和计划轮换日期。

Key 归属于项目，用量也记在项目上；所有项目共享组织余额和组织级限流。项目管理员可以设置月度或日度预算、TPM 上限和短信提醒。预算拦截约有十分钟延迟，不要把它当成实时闸门。

每个成员应创建自己的 Key。成员被移出项目后，其创建的 Key 会失效，这比多人共用一把 Key 更容易追责。

四、Key 的权限边界在哪里

API Key 不是账号密码，也没有“万能权限”。它能调用组织分配给项目的接口和模型，同时受项目预算、组织限流和 IP 白名单约束。控制台若没有提供按模型、按接口细分 Key 的选项，就不要假设它存在；需要隔离时，用不同项目、不同 Key 加应用层配额实现。

还要区分产品：Kimi Code 的 Key 与开放平台 Key 不通用。拿 Code 产品的 Key 调开放平台接口，常见结果是 401 或 404。成员角色、充值、发票权限也是分开的，按最小权限分配，不要把“能创建 Key”当成“能管理账单”。

五、环境变量与代码中的存放

# .env 只放本地，不提交到仓库
MOONSHOT_API_KEY=你的密钥

# .gitignore 至少包含
.env
.env.*

生产环境用平台的 Secret 管理或环境变量注入。前端、移动端和浏览器插件里不出现 Key，所有请求经服务端转发。日志、异常上报和 APM 中过滤 Authorization 头，只记录 Key 名称或前缀。CI/CD 使用独立 Secret，不在构建日志里回显。多人共用开发机时，每人一把开发 Key 更容易定位问题。

六、401、403、429 怎么查

401 先查三件事：Key 属于哪个站、Base URL 是否配套、Key 是否被删除或已轮换。再查复制是否完整、请求头是否为 Authorization: Bearer、环境变量是否真的加载。换一把新建 Key 复测，可以快速区分 Key 问题和配置问题。

403 常见于 IP 白名单未包含当前出口 IP，或项目权限不足。NAT、代理和云函数的出口 IP 可能与你以为的不同。

429 要区分错误类型：engine_overloaded_error 是服务端繁忙，应等待 Retry-After 并降低并发；rate_limit_reached_error 是组织 RPM、TPM、TPD 或并发超限；exceeded_current_quota_error 多是余额不足或欠费。OpenAI SDK 默认会重试两次，一次失败可能变成三次请求，低配额账号要留意。

七、轮换、吊销与泄露处理

  • 常规项目每 90 天轮换一次，核心业务可以更短。
  • 人员变动先吊销再补发，不要只改代码里的字符串。
  • 泄露立即吊销，再检查用量和账单，不要先观察。
  • 重叠发布：新 Key 部署验证后，再吊销旧 Key。
  • 定期清理长期未使用的 Key，避免触顶数量上限。
  • 日志只留 Key 名称，不留完整值。

八、官方 Key 与网关 Key 怎么选

官方平台 Key 的账号在 Kimi API 开放平台，结算、开票和模型范围按平台规则，适合只用 Kimi、需要直连官方接口的团队。

网关 Key 在中商起航 AI 网关创建，一把 Key 可以调用多个模型，账单统一以人民币结算，适合多模型切换或希望统一管理 Key 的团队。具体可用模型和计费方式以模型价格为准。

两条路径不冲突，可以先用网关做测试，再决定生产走哪条。不要把两种 Key 混用，它们的 Base URL、鉴权体系和余额账户都不同。

常见问题

Moonshot API Key 和 Kimi API Key 是一回事吗？

是同一开放平台的凭证，只是叫法不同。平台现在叫 Kimi API 开放平台，接口域名仍是 moonshot。

为什么 platform.moonshot.cn 会跳转？

平台品牌调整后，中国站跳转到 platform.kimi.com，国际站跳转到 platform.kimi.ai。API 域名 api.moonshot.cn 和 api.moonshot.ai 不受影响。

Key 创建后还能查看完整值吗？

多数平台只在创建时展示一次，之后只能看到名称或前缀。没有保存就新建一把，不要试图找回旧值。

一个 Key 可以给多个项目用吗？

技术上往往可以，但不建议。Key 绑定项目便于计费和限流归因，多项目共用会让预算和排障失控。

开了 IP 白名单后调用失败怎么办？

先确认当前出口 IP 是否在列表内，再检查 NAT、代理或云函数的实际出口。修改白名单会覆盖整个列表，保存前把全部地址写全。

下一步

先在中商起航 AI 网关创建一把测试 Key，跑通最小请求后再按项目拆分生产 Key。可用模型与计费方式以模型价格为准。

相关阅读：