目标读者：需要程序化管理 Token 的开发者
一句话目标：Token 的增删改查全部接口
Token 管理 API#
通过 API 创建、查询、修改、删除 API Token。所有接口需要 登录态（Cookie/Session），不是用 API Key 鉴权。
接口总览#
| 操作 | 方法 | 路径 | 说明 |
|---|
| 列表 | GET | /api/token/ | 分页获取所有 Token |
| 详情 | GET | /api/token/{id} | 获取单个 Token |
| 搜索 | GET | /api/token/search | 按名称/值搜索 |
| 创建 | POST | /api/token/ | 创建（支持批量） |
| 更新 | PUT | /api/token/ | 修改 Token 配置 |
| 删除 | DELETE | /api/token/{id}/ | 删除单个 Token |
获取 Token 列表#
GET /api/token/?p={页码}&size={每页数量}
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
p | number | 否 | 1 | 页码 |
size | number | 否 | 10 | 每页条数 |
{
"success": true,
"message": "",
"data": {
"items": [
{
"id": 123,
"name": "my-token",
"remain_quota": 5000000,
"expired_time": -1,
"unlimited_quota": true,
"model_limits": "",
"model_limits_enabled": false,
"group": "default",
"allow_ips": "",
"status": 1,
"created_at": "2025-01-01T00:00:00Z"
}
],
"total": 100,
"page": 1,
"page_size": 10
}
}
获取单个 Token#
| 参数 | 类型 | 必填 | 说明 |
|---|
id | number | ✅ | Token ID |
{
"success": true,
"message": "",
"data": {
"id": 123,
"name": "my-token",
"remain_quota": 5000000,
"expired_time": -1,
"unlimited_quota": true,
"model_limits": "",
"model_limits_enabled": false,
"group": "default",
"allow_ips": "",
"status": 1,
"created_at": "2025-01-01T00:00:00Z"
}
}
搜索 Token#
GET /api/token/search?keyword={关键词}&token={token值}&p={页码}&size={数量}
| 参数 | 类型 | 必填 | 说明 |
|---|
keyword | string | 否 | 按名称模糊搜索 |
token | string | 否 | 按 token 值精确搜索 |
p | number | 否 | 页码 |
size | number | 否 | 每页条数 |
创建 Token#
| 字段 | 类型 | 必填 | 说明 |
|---|
name | string | ✅ | 令牌名称，建议用项目名标识 |
remain_quota | number | ✅ | 初始额度 |
expired_time | number | ✅ | 过期时间（Unix 时间戳），-1 = 永不过期 |
unlimited_quota | boolean | 否 | 无限额度，默认 false |
model_limits | string | 否 | 允许的模型，逗号分隔（如 "gpt-5.4,claude-sonnet-4-6"） |
model_limits_enabled | boolean | 否 | 是否启用模型白名单 |
group | string | 否 | 令牌分组 |
allow_ips | string | 否 | IP 白名单，支持 CIDR（如 "192.168.1.0/24,10.0.0.1"） |
cross_group_retry | boolean | 否 | 跨分组重试 |
tokenCount | number | 否 | 批量创建数量（1-100） |
{
"success": true,
"message": "",
"data": {
"id": 124,
"name": "prod-backend",
"key": "xxxxxxxxxxxx"
}
}
更新 Token#
| 字段 | 类型 | 必填 | 说明 |
|---|
id | number | ✅ | 要更新的 Token ID |
| 其他字段 | — | 否 | 同「创建」，只传需要修改的字段 |
{
"success": true,
"message": "令牌更新成功！"
}
删除 Token#
| 参数 | 类型 | 必填 | 说明 |
|---|
id | number | ✅ | Token ID |
{
"success": true,
"message": "删除成功"
}
删除后该 Token 立即失效，所有使用该 Key 的请求将返回 401。此操作不可恢复。
Token 数据结构#
| 值 | 含义 | 图标 |
|---|
1 | 启用（Active） | 🟢 |
2 | 禁用（Disabled） | 🔴 |
