修改 API Key
PUT /api/token/
说明
修改本人名下某条 API Key。
两种调用模式
- 仅修改状态（快捷启用/禁用）：URL 加上
?status_only=1，body 只传id+status即可 - 全量修改：不传
status_only，body 需传完整字段（未传字段会被默认零值覆盖）
状态转移限制
将 status 改回 1（启用）时：
- 若原状态 =
3且expired_time已超期且 ≠ -1，拒绝 - 若原状态 =
4且remain_quota≤ 0 且非无限额度，拒绝
请求头
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| status_only | query | string | 否 | 非空时仅更新 status 字段（其他字段志留） |
| Authorization | header | string | 是 | 系统访问令牌 |
| New-Api-User | header | string | 是 | 用户 ID |
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | integer | 是 | API Key id |
| status | integer | 否 | 1=启用 2=禁用 |
| name | string | 否 | |
| expired_time | integer | 否 | -1 表示永不过期 |
| remain_quota | integer | 否 | |
| unlimited_quota | boolean | 否 | |
| model_limits_enabled | boolean | 否 | |
| model_limits | string | 否 | |
| allow_ips | string | 否 | |
| group | string | 否 | |
| cross_group_retry | boolean | 否 |
响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | boolean | 否 | |
| message | string | 否 | |
| data | object | 否 | 更新后的 API Key（key 已脱敏） |