API Key
预算、限速与白名单
给每把 Key 设上限,防止被刷、被泄露后花光余额。
约 8 分钟适合:想控制花费和使用范围的用户
开始之前
- 已经创建了至少一把 Key
步骤 1 · STEP 0x01
设预算
编辑 Key
1
5 小时
留空 = 不限
2
1 天
留空 = 不限
3
7 天
留空 = 不限
4
每月 / 累计
留空 = 不限
5
保存
预算单位是美元,几项可以同时设,任何一项用完请求就会被拒绝。5 小时、1 天、7 天是滚动窗口:窗口里的花费滑出去后,额度自动恢复。
预算用完时请求返回 429,错误码是 key_budget_exceeded,提示会写明是哪个窗口、大约什么时候恢复。
步骤 2 · STEP 0x02
限制模型和来源 IP
编辑 Key
1
模型白名单(逗号分隔,留空不限)
填模型广场里复制的模型名
2
IP 白名单(逗号分隔,支持 CIDR,留空不限)
你的服务器出口 IP
3
过期日期
永不
4
保存
- 模型白名单:这把 Key 只能调用列出的模型,适合给只用一个模型的脚本。
- IP 白名单:只有来自这些地址的请求才有效,适合固定出口 IP 的服务器;个人电脑 IP 经常变,不建议设。
- 过期日期:临时给别人用的 Key,设好到期日就不用记得去吊销。
步骤 3 · STEP 0x03
了解限速
| 限制 | 说明 |
|---|---|
| RPM / TPM / 并发 | 每分钟请求数、每分钟 token 数、同时进行的请求数。账户按累计充值自动升档,只升不降。 |
| Key 级限速 | 可以比账户档位更严格,不能更宽松。 |
| 账户日上限 | 账户级的每日消费保护;账户受限时页面会显示当前的每日上限。 |
response headers
HTTP/1.1 429 Too Many Requestsretry-after: 3x-ratelimit-limit-requests: …x-ratelimit-remaining-requests: 0
遇到 429 就按指数退避重试(等 1 秒、2 秒、4 秒…);需要更高额度,提交工单说明用途。
✓ 怎么确认成功了
- 保存后列表里「用量」一列显示
本月 … / 上限,超出预算的请求会得到 429。
常见问题
预算设了,余额还会被花光吗?
预算只限制这一把 Key。账户里有多把 Key 时,每把各自受自己的预算限制,合计不会超过各自预算之和。
改了预算多久生效?
保存后新请求即按新设置执行,进行中的请求不受影响。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。