Kimi API Key 是调用开放平台的凭证，不等于网页版会员，也不等于充值余额。很多团队第一次接入时卡住，不是模型不会用，而是站点点错、Key 存错、或者把会员账号当成了 API 账号。
本文按实际操作顺序讲：先分清账号体系，再走注册、认证和创建 Key 的流程，然后给出存储、轮换和 401 排查方法，最后比较官方 Key 与网关 Key 的适用场景。模型与价格以站内模型价格为准。
说明：Moonshot、Kimi 是其权利人的商标，本文仅作技术接入说明。平台入口、认证要求和 Key 管理规则可能调整，请以官方控制台当前页面为准。
一、先分清三种“Kimi 账号”
| 类型 | 入口 | 用途 | 余额与 Key |
|---|---|---|---|
| Kimi 网页与 App 会员 | kimi.com | 聊天产品 | 与 API 相互独立 |
| Kimi 开放平台（中国站） | platform.kimi.com | 国内 API 调用 | 独立账号、余额和 Key |
| Kimi 开放平台（国际站） | platform.kimi.ai | 海外 API 调用 | 与中国站完全独立 |
中国站和国际站的 Key 不能混用。把中国站 Key 配到国际站地址，或者反过来，常见结果就是 401。另有第三条路径：在中商起航 AI 网关创建网关 Key，用它调用包括 Kimi 在内的多个模型，Key 由网关管理，余额也在网关账户里。
先确定业务走哪个站，再注册。不要一边用会员账号找 Key，一边在开放平台充值，这是两类产品。
二、注册与实名认证
- 打开 platform.kimi.com，按页面提示完成注册和登录。
- 进入用户中心，完成个人实名认证；企业调用则完成企业认证。
- 企业认证通常要准备企业名称、与主体一致的银行账户、统一社会信用代码。
- 平台会向企业对公账户打入一笔随机金额，联系财务确认后回填，金额一致即通过。
- 认证通过后再充值。个人用户可在线充值，企业用户还可选择对公转账。
- 回到控制台，确认账户状态、余额和可用模型。
认证主体只能从个人变更为企业，不支持企业改回个人，注册时就要想清楚用哪个主体。开票、合同和采购通常也绑定这个主体，后面再改会很麻烦。
三、创建 API Key 的步骤
- 登录后进入
https://platform.kimi.com/console/api-keys。 - 点击创建 API Key，按“项目-环境-用途”命名，例如
crm-prod-chat。 - 复制生成的 Key。若页面只展示一次，当场存入密钥管理器，不要留在聊天记录里。
- 在测试环境发一条最小请求，确认 Key、站点和模型名三项都正确。
- 记录创建时间、负责人、绑定项目和计划轮换日期。
- 生产、测试、个人调试各用独立 Key，不要多人共用一把。
Key 的权限范围、是否支持按项目或成员细分，以控制台实际提供的选项为准。控制台没有提供的权限，不要假设它存在；需要隔离时，用多个账号或多个 Key 加应用层配额来实现。
四、轮换、吊销与权限收口
建议把 Key 当成有生命周期的凭证，而不是一次创建永久使用。
- 定期轮换：常规项目每 90 天轮换一次；核心业务可以更短。
- 人员变动立即轮换：离职、转岗、外包结束时，先吊销再补发。
- 泄露立即吊销：不要先观察用量，先停用再排查。
- 重叠发布：先创建新 Key，部署并验证，再吊销旧 Key，避免切换瞬间中断。
- 最小权限：一把 Key 只服务一个项目或一个环境，出问题时影响面可控。
- 留痕：日志只记录 Key 前缀和名称，不记录完整值。
轮换不是形式。很多“额度突然被刷光”的事故，源头都是旧 Key 留在脚本、仓库或聊天记录里。
五、安全存储：环境变量只是起点
最底线的做法是不把 Key 写进代码。本地开发用 .env，并确保它被 Git 忽略；生产环境用平台的密钥管理服务或环境变量注入。
# .env 只放在本地，不提交到仓库
MOONSHOT_API_KEY=你的密钥
# .gitignore 至少包含
.env
.env.*
再往上做三件事：
- 前端、移动端和浏览器插件里绝不出现 Key，所有调用经服务端转发。
- 日志、异常上报和 APM 里过滤
Authorization头，避免 Key 被完整打印。 - CI/CD 用独立的 Secret 管理，不在构建脚本里明文回显。
如果团队多人共用一台开发机，环境变量并不够隔离。更稳妥的是每人一把开发 Key，按人记录用量，出问题能定位到人。
六、401 排查顺序
401 不一定是 Key 错了。按下面顺序查，通常几分钟能定位。
| 现象 | 常见原因 | 处理 |
|---|---|---|
invalid_authentication_error |
Key 格式错误、已删除、复制不完整 | 重新创建并完整复制 |
incorrect_api_key_error |
未带 Key、Header 拼写错误 | 检查 Authorization: Bearer |
| 401 且刚换过环境 | 中国站与国际站 Key 混用 | 统一站点与 Base URL |
403 permission_denied_error |
IP 白名单、接口未开通 | 查控制台权限与网络出口 |
| 404 | Base URL 或模型名错误 | 查模型列表与接口路径 |
逐项检查：
- Key 属于哪个站，Base URL 是否配套。
- Key 前后是否有空格、换行、引号。
- 环境变量是否真的加载，可以只打印前几位确认。
- Key 是否被删除、禁用或已轮换。
- 请求头是否为
Authorization: Bearer <key>。 - 路径是否为
/v1/chat/completions，有没有多写或漏写/v1。 - 换一把新 Key 复测，区分 Key 问题和网关配置问题。
七、官方 Key 与网关 Key 怎么选
| 对比项 | 官方直连 | 中商起航 AI 网关 |
|---|---|---|
| 创建入口 | Kimi 开放平台控制台 | 网关控制台 |
| 账号体系 | 中国站或国际站 | 网关账户 |
| 结算 | 平台充值，按平台规则开票 | 人民币充值，按网关规则开票 |
| 模型范围 | Kimi 系列 | 多模型统一入口 |
| 适合场景 | 只用 Kimi、需要官方直连能力 | 多模型切换、统一账单与 Key |
只用 Kimi、团队在国内、官方访问顺畅，直连最省事。需要同时用 DeepSeek、GLM、Claude，或者希望一个 Key 管多个模型、统一人民币账单，网关更合适。两条路径不冲突，可以先用网关做测试，再决定生产走哪条。
八、团队落地清单
- 明确 API 使用主体，完成对应认证。
- 一站一账号，不混用中国站与国际站。
- 一项目一 Key，一环境一 Key。
- Key 只进密钥管理器，不进代码库。
- 设定轮换周期和责任人。
- 开启余额提醒，避免欠费导致调用被拒或返回 429。
- 在监控里区分 401、403、429，不要都当成“Key 失效”。
常见问题
Key 泄露了怎么办？
立即在控制台吊销或删除该 Key，创建新 Key 并部署，然后检查用量和账单。不要只改代码里的字符串，旧 Key 只要没吊销就仍然可用。
一个 Key 可以给多个项目用吗？
技术上通常可以，但不建议。多项目共用会让用量、限流和故障无法归因。按项目拆分 Key，配合应用层配额，排障成本更低。
Kimi API Key 会过期吗？
是否设置有效期以控制台当前规则为准。即使平台不强制过期，也建议主动轮换，尤其是人员变动或长期未使用的 Key。
充值后还是 401 怎么办？
先确认充值和 Key 属于同一个站、同一个主体。再换一把新建 Key 测试，排除旧 Key 被删除、环境变量未刷新或代码里写死旧值的情况。
官方 Key 和网关 Key 能混用吗？
不能。两者的 Base URL、鉴权体系和余额账户都不同。混用的典型表现是 401 或 404，切换时要把 Key、Base URL 和模型名一起改。
下一步
先在中商起航 AI 网关创建一把测试 Key，用最小请求验证链路，再按项目拆分生产 Key。可用模型与计费方式以模型价格为准。
相关阅读：
