认证
如何携带 Key、推理 Key 和 CLI 管理 Key 各自能做什么,以及单 Key 额度如何生效。
携带 Key
两种请求头任选其一,所有 /v1 路由都认,所以 OpenAI 和 Anthropic 的 SDK 不用改。
Authorization: Bearer sk-token-...别把 Key 写进代码里,从 TOKEN_SHARE_KEY 这类环境变量读取。缺失、无效、已吊销、已过期的 Key 一律返回同样的 401 invalid api key。
Key 类型
在 API Keys 页面 创建时选择类型。分成两种,是为了让泄露的 Key 做不了它本职以外的事。
| 类型 | 可以 | 不可以 |
|---|---|---|
| 推理 | 在 /v1 上调用模型;通过账单 API 查询自己发出的请求费用和自己的额度 | 看账户余额或其他 Key 的请求;列出、创建、吊销 Key |
| CLI 管理 | 登录 token CLI、创建推理 Key、读取账户用量;通过账单 API 查看整个账户的请求和余额 | 调用模型 |
单 Key 额度
所有 Key 共用账户余额。你也可以给某把 Key 单独设一个美元额度上限,让某个项目或同事最多只能花这么多;不设上限时只受账户余额约束。
鉴权、模型、余额这几项检查都在转发之前完成,被拒绝的请求不产生费用。某把 Key 的额度还剩多少,用 GET /v1/billing/balance 查,见 账单 API。
吊销 Key
在 API Keys 页面 吊销,下一次请求起即失效。用到它的地方换一把新 Key 即可。