Skip to content

POST /api/user/api-keys/:id/reset-usage

请求

内容
方法POST
路径/api/user/api-keys/:id/reset-usage
鉴权登录用户

Header 参数

参数位置类型必填说明
AuthorizationHeaderstringBearer <jwt>
Content-TypeHeaderstringapplication/json

Path 参数

参数位置类型必填说明
idPathstring路径参数 id

Query 参数

无。

Body 参数

无。

返回值

重置成功响应。

返回字段

字段类型说明
idnumberAPI Key ID。
namestring令牌名称。
api_keystring完整密钥;仅创建或轮换后返回一次,列表通常为空。
key_prefixstring密钥前缀。
allowed_modelsarray允许的模型名列表,空数组表示不限模型。
allowed_user_channelsarray允许的用户渠道 ID;当前后端要求恰好绑定一个用户渠道。
allowed_ipsarray允许来源 IP/CIDR,空数组表示不限 IP。
quota_limitstring/number额度上限,0 表示不限。
quota_remainingstring/number/null剩余额度,仅 quota_limit 大于 0 时返回。
enabledboolean是否启用。
usageobject用量统计。
usage.request_countnumber请求数。
usage.input_tokensnumber输入 token 数。
usage.output_tokensnumber输出 token 数。
usage.cached_input_tokensnumber缓存输入 token 数。
usage.total_tokensnumber输入加输出 token 数。
usage.total_coststring/number累计费用。
last_used_atstring/null最后使用时间。
usage_reset_atstring/null用量重置起点。
created_atstring创建时间。
updated_atstring更新时间。

错误

状态码说明
400参数不合法。
401未登录或登录失效。
403无权限。
404资源不存在。
500服务端错误。

基于 MIT 协议发布(社区版)