主题
令牌管理
令牌(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 令牌字段可能调整,新建令牌的完整字段以控制台表单与接口实际返回为准。