密钥限额、有效期与 IP 限制
给共享设备、自动化任务或临时用途设置明确边界,防止密钥被滥用、防资损。
支持的三种限制
| 限制类型 | 作用 | 适用场景 |
|---|---|---|
| 额度限制 | 密钥总消耗达到上限后自动失效 | 给朋友/共享设备限定预算 |
| 速率限制 | 限制每分钟/每小时请求次数 | 防止脚本疯狂调用 |
| 过期时间 | 到期自动失效 | 临时任务、试用 |
设置方法
创建密钥时,或在「API 密钥」页点击密钥的编辑按钮:
- 额度限制:填写美元额度或 Token 数上限
- 速率限制:填写时间窗口与最大次数
- 过期时间:选择日期,到期密钥自动停用
IP 限制(若站长开放)
部分站点支持为密钥设置 IP 白名单/黑名单:
- IP 白名单:只有列表内的 IP 能调用,其余拒绝
- IP 黑名单:列表内的 IP 被拒绝,其余放行
TIP
- 办公网 IP 会变化,设置白名单前先确认你的出口 IP
- 使用代理/VPN 会改变出口 IP,可能导致调用失败
- 修改密钥时若 IP 限制被静默清空(旧版本问题),请检查后重新设置
限额用尽会怎样
- 返回 429(频率超限)或 403/余额不足(额度用尽)
- 密钥不会自动恢复,需要调整限制或等过期后重建
推荐组合
| 场景 | 建议配置 |
|---|---|
| 自己主力机 | 不设限或高额度 + 无过期 |
| 共享给朋友 | 额度 $5 + 速率 60/min + 无过期 |
| 临时自动化任务 | 额度 $1 + 速率 30/min + 7 天过期 |
| 服务器固定 IP | 加 IP 白名单更安全 |
