Skip to content

API Key 与分组 ​

MoonApiX API Key 用于调用所有公开接口。你可以为不同项目、团队或用途创建不同的 API Key,并用分组控制可用模型、额度和有效期。

创建 API Key ​

  1. 登录 MoonApiX 控制台。
  2. 进入 API Key 管理页面。
  3. 选择用途或分组。
  4. 设置名称、额度和有效期。
  5. 创建后保存密钥,并只在服务端环境变量中使用。

请求时使用:

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。
  • 如果密钥出现在聊天记录、日志、截图或公开页面,应立即轮换。

更多鉴权说明见 鉴权。