跳到主要内容

更新令牌

PUT /api/token/

更新当前用户指定令牌的配置。通过请求体中的 id 指定要更新的令牌。支持通过 status_only 参数仅更新状态。

鉴权说明

用户控制台接口，需登录用户身份（会话 Cookie，或 Authorization: Bearer <access_token>）。

Query 参数

参数名	类型	必选	说明
`status_only`	`string`	可选	非空时仅更新令牌 `status` 字段，忽略其他字段

请求参数

参数名	类型	必选	说明
`id`	`integer`	必选	要更新的令牌 ID
`status`	`integer`	可选	状态：`1` 启用、`2` 禁用等。已过期或已耗尽的令牌不可直接启用
`name`	`string`	可选	令牌名称，长度不超过 50
`expired_time`	`integer`	可选	过期时间（Unix 时间戳，秒）；`-1` 表示永不过期
`remain_quota`	`integer`	可选	剩余额度
`unlimited_quota`	`boolean`	可选	是否无限额度
`model_limits_enabled`	`boolean`	可选	是否启用模型限制
`model_limits`	`string`	可选	允许的模型列表（逗号分隔）
`allow_ips`	`string`	可选	允许访问的 IP 列表
`group`	`string`	可选	令牌分组
`cross_group_retry`	`boolean`	可选	是否跨分组重试
`refill_enabled`	`boolean`	可选	是否启用额度补足
`refill_interval_days`	`integer`	可选	补足周期（天）
`refill_target_quota`	`integer`	可选	补足目标额度
`refill_max_count`	`integer`	可选	最大补足次数
`refill_remain_count`	`integer`	可选	剩余补足次数

请求示例

{
  "id": 123,
  "name": "renamed-token",
  "expired_time": -1,
  "unlimited_quota": true
}

响应字段（200）

字段名	类型	说明
`success`	`boolean`	是否成功
`message`	`string`	提示信息
`data`	`object`	更新后的令牌对象，结构见获取所有令牌的「令牌对象」

Query 参数
请求参数
请求示例
响应字段（200）