跳到主要内容

创建令牌

POST /api/token/

为当前用户创建一个新的 API 令牌。密钥由服务端自动生成,无需在请求中提供。令牌数量受站点上限限制。

鉴权说明

用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>)。

请求参数​

请求体为令牌对象,服务端仅采用以下字段(key、id 等由服务端生成或忽略):

参数名类型必选说明
namestring可选令牌名称,长度不超过 50
expired_timeinteger可选过期时间(Unix 时间戳,秒);-1 表示永不过期
remain_quotainteger可选剩余额度;unlimited_quota 为 false 时必须在有效范围内
unlimited_quotaboolean可选是否无限额度
model_limits_enabledboolean可选是否启用模型限制
model_limitsstring可选允许的模型列表(逗号分隔)
allow_ipsstring可选允许访问的 IP 列表
groupstring可选令牌分组
cross_group_retryboolean可选是否跨分组重试(仅 auto 分组有效)
refill_enabledboolean可选是否启用额度补足;无限额度时强制为 false
refill_interval_daysinteger可选补足周期(天);启用补足时须大于 0
refill_target_quotainteger可选补足目标额度;启用补足时须大于 0
refill_max_countinteger可选最大补足次数;-1 表示不限

请求示例​

{
"name": "my-token",
"expired_time": -1,
"unlimited_quota": true,
"group": "default"
}

响应字段(200)​

字段名类型说明
successboolean是否成功。名称过长、额度非法或达到令牌数量上限时为 false
messagestring提示信息
dataobject新建的令牌对象(含自动生成的 key),结构见 获取所有令牌 的「令牌对象」