KovAPIKovAPI

创建、使用、限制、更换和保管 API Key。

创建 API Key

  1. 登录后打开控制台「API Keys」页面,给 Key 起一个能认出用途的名字。
  2. 按需要设置限制(每分钟请求数、预算、白名单),也可以以后再改。
  3. 创建后,Key 出现在列表里,点「复制」拿到完整的 Key(以 sk- 开头),保存到安全的地方,例如服务器的环境变量。

管理 API Key →

在请求里带上 Key

OpenAI 兼容接口用 Authorization: Bearer 请求头;Anthropic 接口用 x-api-key,也接受 Authorization: Bearer。建议把 Key 放在环境变量里,不要写进代码。

Header
Authorization: Bearer YOUR_API_KEY

给 Key 加限制

每把 Key 都可以单独设置下面这些限制,互不影响:

设置作用
每分钟请求数这把 Key 每分钟最多发多少个请求。
每日预算这把 Key 每天(UTC)最多花多少美元。
总额度这把 Key 一共最多花多少美元,适合交给自动化任务、防止跑飞。
模型白名单这把 Key 只能调用列出的模型。
IP 白名单只接受来自列出的 IP 或网段的请求。

超出限制时返回什么 →

停用与更换

  1. 先新建一把 Key,把用到的地方换成新的。
  2. 确认新 Key 在正常调用后,在控制台停用旧 Key;停用立即生效,之后旧 Key 的请求返回 401。
  3. 怀疑 Key 泄露时,先停用,再新建。

安全建议

  • Key 只放在服务端;不要写进网页、App 或公开的代码仓库。
  • 每个应用、每个环境用一把单独的 Key,出问题时只停那一把。
  • 给自动化任务和第三方工具用的 Key 设上预算或总额度。
  • 服务器 IP 固定时,打开 IP 白名单。

余额属于账户

同一个账户下的所有 Key 共用一个余额。用任意一把 Key 调用 GET /v1/usage 都能查到账户余额和消费。