每把密钥可以设置什么
| 设置 | 作用 | 超出后 |
|---|---|---|
| 分组 | 决定能用的模型和计费倍率 | 调用分组外的模型返回 404 |
| 额度上限 | 这把密钥累计最多能花多少，0 表示不限制 | 429，提示“API key 额度已用完” |
| 时间窗口上限 | 5 小时、1 天、7 天内最多能花多少 | 429，API_KEY_RATE_5H_EXCEEDED 等 |
| 有效期 | 到期后自动失效，也可以设为永久 | 403，API_KEY_EXPIRED |
| IP 白名单 / 黑名单 | 每行一个 IP 或 CIDR，只允许或禁止这些地址使用 | 403，ACCESS_DENIED |
| 启用 / 禁用 | 临时停用，之后还能恢复 | 401，API_KEY_DISABLED |
金额上限的单位以控制台输入框里显示的为准。额度和时间窗口上限只限制这把密钥，账户余额用完时所有密钥都会停止（403，INSUFFICIENT_BALANCE）。
停用和删除
- 禁用：在「API 密钥」列表里点「禁用」，之后用这把密钥的请求返回 401，可以随时重新启用。
- 删除：彻底删除，不能恢复，之后返回 401
INVALID_API_KEY。 - 密钥泄露时，先禁用或删除，换上新密钥，再到「使用记录」看看有没有不认识的请求。
用接口查用量
用密钥本身就能查它的用量，这个请求不消耗额度：
curl https://api.mallowapi.com/v1/usage \
-H "Authorization: Bearer $MALLOW_API_KEY"返回这把密钥今天和累计的请求数、各类 token 数与费用。CC Switch 一键导入后显示的余额，也是从这个接口读的。更详细的逐条记录在控制台「使用记录」里看。