PUT
更新 API 密钥

授权

Authorization
string
header
必填

个人访问令牌(nap_ 开头),在控制台「安全与访问 → 访问令牌」中创建,不是 sk- 开头的 API 密钥。

查询参数

status_only
string

传任意非空值(如 true)时只修改状态,请求体只需 id 和 status

请求体

application/json
id
integer
必填

要修改的密钥 ID

示例:

1

status
integer

状态:1 启用,2 禁用。仅 status_only 时生效

示例:

1

name
string

密钥名称,最多 50 个字符

示例:

"my-key"

remain_quota
integer

额度(内部额度单位)。unlimited_quota 为 true 时忽略

示例:

500000

unlimited_quota
boolean

是否无限额度

示例:

false

expired_time
integer

过期时间(Unix 秒),-1 表示永不过期

示例:

-1

model_limits_enabled
boolean

是否启用模型限制

示例:

false

model_limits
string

允许调用的模型,逗号分隔;启用模型限制时生效

示例:

""

allow_ips
string

IP 白名单,每行一个;为空表示不限制

示例:

""

group
string

密钥分组;为空表示使用账户分组

示例:

""

cross_group_retry
boolean

跨分组重试,仅 group 为 auto 时有效

示例:

false

auto_groups
string[]

group 为 auto 时依次尝试的分组

allow_user_quota_query
boolean

是否允许用这个密钥查询账户余额,新建时默认开启

示例:

true

响应

200 - application/json

成功

success
boolean

是否成功

示例:

true

message
string

失败时为错误原因

示例:

""

data
object