文档目录

认证

如何携带 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 即可。