Appearance
API Key 与分组
MoonApiX API Key 用于调用所有公开接口。你可以为不同项目、团队或用途创建不同的 API Key，并用分组控制可用模型、额度和有效期。
创建 API Key
- 登录 MoonApiX 控制台。
- 进入 API Key 管理页面。
- 选择用途或分组。
- 设置名称、额度和有效期。
- 创建后保存密钥，并只在服务端环境变量中使用。
请求时使用：
http
Authorization: Bearer <MOONAPIX_API_KEY>分组用途
| 场景 | 建议 |
|---|---|
| 本地开发 | 使用单独 API Key，额度较低，便于随时轮换。 |
| 线上服务 | 使用独立 API Key，只开放业务需要的模型。 |
| 客户项目 | 每个客户或项目使用单独 API Key，便于统计和停用。 |
| 临时测试 | 设置较短有效期，测试结束后删除。 |
权限和额度
分组通常会影响：
- 可调用的模型。
- 单次或每日额度。
- API Key 有效期。
- 并发和速率限制。
如果请求返回 401、403 或模型不可用，请先确认 API Key 是否有效、是否属于正确分组、是否具备对应模型权限。
安全建议
- 不要把 API Key 写进前端代码、移动端安装包或公开仓库。
- 不要把 API Key 放在 URL query 中。
- 在服务端读取环境变量，例如
MOONAPIX_API_KEY。 - 如果密钥出现在聊天记录、日志、截图或公开页面，应立即轮换。
更多鉴权说明见 鉴权。