创建令牌
POST /api/token/
为当前用户创建一个新的 API 令牌。密钥由服务端自动生成,无需在请求中提供。令牌数量受站点上限限制。
鉴权说明
用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>)。
请求参数
请求体为令牌对象,服务端仅采用以下字段(key、id 等由服务端生成或忽略):
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
name | string | 可选 | 令牌名称,长度不超过 50 |
expired_time | integer | 可选 | 过期时间(Unix 时间戳,秒);-1 表示永不过期 |
remain_quota | integer | 可选 | 剩余额度;unlimited_quota 为 false 时必须在有效范围内 |
unlimited_quota | boolean | 可选 | 是否无限额度 |
model_limits_enabled | boolean | 可选 | 是否启用模型限制 |
model_limits | string | 可选 | 允许的模型列表(逗号分隔) |
allow_ips | string | 可选 | 允许访问的 IP 列表 |
group | string | 可选 | 令牌分组 |
cross_group_retry | boolean | 可选 | 是否跨分组重试(仅 auto 分组有效) |
refill_enabled | boolean | 可选 | 是否启用额度补足;无限额度时强制为 false |
refill_interval_days | integer | 可选 | 补足周期(天);启用补足时须大于 0 |
refill_target_quota | integer | 可选 | 补足目标额度;启用补足时须大于 0 |
refill_max_count | integer | 可选 | 最大补足次数;-1 表示不限 |
请求示例
{
"name": "my-token",
"expired_time": -1,
"unlimited_quota": true,
"group": "default"
}
响应字段(200)
| 字段名 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否成功。名称过长、额度非法或达到令牌数量上限时为 false |
message | string | 提示信息 |
data | object | 新建的令牌对象(含自动生成的 key),结构见 获取所有令牌 的「令牌对象」 |