Skip to content

令牌管理

令牌(Token)是调用 API 的凭证。除在控制台界面管理外,也可通过 API 自动化管理。

控制台操作

在「令牌」页面可:

  • 新建令牌:设置名称、可用分组、额度上限、有效期、可用模型、IP 限制。
  • 复制 Key:令牌创建后显示完整的 sk-xxxxxxxx,仅此一次完整可见,请及时保存。
  • 修改 / 删除:随时调整令牌属性或删除。
  • 查看用量:查看每个令牌的已用配额、剩余配额。

令牌 vs 用户额度

令牌额度从用户总额度里扣除。令牌额度上限用于细分控制(例如给某个应用单独限额),不影响用户总额度本身。

API 管理

令牌管理 API 需用用户登录态(Session Cookie)调用,不是用 sk- 令牌本身。适合在自动化脚本里管理自己的令牌。

获取令牌列表

GET /api/token/?p=1&size=10

新建令牌

POST /api/token/
Content-Type: application/json

{
  "name": "my-token",
  "group": "default",
  "remain_quota": 500000,
  "expired_time": -1,
  "model_limits_enabled": false
}
  • group:分组名,决定走哪个上游渠道。
  • remain_quota:额度上限(单位为配额,500000 = $1),-1 表示不限。
  • expired_time:过期 Unix 时间戳(秒),-1 表示永不过期。

修改 / 删除令牌

PUT  /api/token/        # 修改(body 带令牌 id 与新字段)
DELETE /api/token/:id   # 删除

字段以控制台为准

不同版本的 New API 令牌字段可能调整,新建令牌的完整字段以控制台表单与接口实际返回为准。

基于 New API(AGPLv3)二次开发