算力猫
← 返回教程列表

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)。