什么是 Kimi API Key？
格式
Kimi API key 是一个唯一的认证令牌（例如 sk-xxxxxxxxxxxxx），用于识别您的账户并授权 API 请求。
认证
在所有对 kimi-api.com/v1 端点的请求中，将您的 API key 作为 'Bearer YOUR_API_KEY' 包含在 Authorization 头中。
计费
API 使用量通过您的 key 追踪，按 ¥8/百万token 计费（官方 Moonshot API 价格的40%）。按需付费，无订阅。
安全
像对待密码一样对待您的 Kimi API key。切勿在客户端代码、公共仓库中暴露它，或公开分享。
如何获取您的 Kimi API Key
提交您的邮箱
在 kimi-api.com 主页填写联系表单，提供您的邮箱地址和使用场景。
接收确认
我们的团队将在72小时内联系您，验证您的请求并讨论使用需求。
获取 API Key
通过邮件接收您的专属 Kimi API key，以及设置说明和计费信息。
设置环境变量
将您的 API key 安全地存储在环境变量中：export KIMI_API_KEY='sk-xxxxx'
测试连接
进行测试 API 调用，验证您的 key 与 Kimi K2.5 或 moonshot-v1 模型正常工作。
开始构建
使用 OpenAI SDK 将 Kimi API 集成到您的应用中，设置 base_url='https://kimi-api.com/v1'。
使用代理的 Kimi API Key
Official Endpoint
https://api.moonshot.cn/v1官方 Moonshot API 端点需要中国手机验证，收费 ¥20/百万token。
Proxy Endpoint
https://kimi-api.com/v1我们的代理端点使用相同的 API 格式，但成本仅为 ¥8/百万token（节省60%），无验证麻烦。
Kimi API Key 最佳实践
DO
- +将 API key 存储在环境变量中，切勿在源代码中硬编码
- +为开发、预发布和生产环境使用独立的 key
- +定期轮换 API key（每90天），以最小化安全风险
- +监控使用量并设置计费警报以防止意外费用
DON'T
- -不要将 API key 提交到 Git 仓库或在 GitHub、GitLab 上分享
- -不要在客户端 JavaScript 或移动应用代码中暴露 key
- -不要通过邮件、Slack 或其他不安全渠道分享 API key
- -不要在多个项目或团队中使用同一个 key
常见 Kimi API Key 问题
401 Unauthorized - 无效的 API Key
Cause: API key 不正确、已过期或格式错误
Fix: 验证 key 格式（以 sk- 开头），检查拼写错误，确保没有空格，联系支持重新签发
429 Too Many Requests - 速率限制
Cause: 超过速率限制（默认：60次请求/分钟）
Fix: 实现指数退避，降低请求频率，联系我们提高速率限制
402 Payment Required - 额度不足
Cause: 账户余额耗尽，未绑定付款方式
Fix: 充值账户余额，添加付款方式，检查计费面板的使用情况
连接超时
Cause: 网络问题，防火墙阻止 kimi-api.com，连接缓慢
Fix: 检查互联网连接，验证防火墙允许 HTTPS 访问 kimi-api.com，增加超时时间至60秒
API Key 意外暴露
Cause: Key 被提交到公共仓库或公开分享
Fix: 立即联系支持撤销 key，请求新 key，使用 git-secrets 或 pre-commit hooks 防止未来泄露