Skip to main content
令牌管理 API 做的事情和控制台「令牌」页相同,但可以写进程序:例如给每个下游客户自动发一把限额 Key,或在项目结束时批量停用。用这些 Key 调用模型产生的费用,都从你的账户余额扣除。
AccessToken 拥有账户的全部权限,只放在服务端。
  • 不要下发到浏览器、App 或交给下游客户;下游只拿到你为他们创建的 API Key。
  • 令牌无效时接口返回 HTTP 200 加 success: false,每次都要检查 success。

接口一览

列表和搜索每页 10 条,p 从 0 开始。列表里的 key 是打码后的值,要拿到能调用模型的完整密钥,用「取回完整密钥」接口。

创建字段

billing_type 决定这把 Key 能调用哪些模型:按量计费只能调按量模型,按次计费只能调按次模型,按量优先两类都能调。三种模式的区别见计费说明。

创建并取回密钥

下面的脚本创建一把额度 5 美元、30 天有效、只能调用两个模型的 Key,再取回完整密钥。需要 requests(python -m pip install requests)。
取回的密钥可以直接用作模型调用的 API Key(Authorization: Bearer <key>),前面加不加 sk- 都能用。把它交给下游前保存到你的密钥系统,之后不要频繁调用取回接口,它有严格的频率限制。

修改、禁用和删除

修改时要提交完整的令牌对象:先用 GET /api/token/{id} 读出来,改需要的字段,再整体 PUT。只提交几个字段,其他字段可能被重置。
修改和启停立即生效:
  • 禁用或删除后,用这把 Key 调用模型返回 HTTP 401 Invalid token.。
  • 调用白名单以外的模型返回 HTTP 403 该令牌无权使用模型:<模型 ID>。

错误处理

常见问题

下游客户用的 Key 会扣谁的钱?

扣你的账户余额。通过 remain_quota 给每把 Key 设上限,用完后这把 Key 停止工作,不会继续消耗账户里的其他余额。

怎么统计每把 Key 用了多少?

列表和详情里的 used_quota 是这把 Key 累计消耗的额度。要按时间或模型拆分,用日志查询 API 加 token_name 筛选。

用了 model_limits 字段,为什么没生效?

模型白名单只认 models 字段。把允许的模型 ID 用英文逗号连起来写在 models 里。

相关文档