疑难排查 · Cursor
使用自有 API 密钥时 Cursor 的速率限制 / 429
使用自定义 API 密钥时,Cursor 中的 429 是该密钥背后账户的速率或并发上限,而不是 Cursor 套餐的限制。为什么代理运行会触发它,以及如何打破循环。
你看到的报错
HTTP 429
{"error":{"message":"Rate limit reached. Please retry shortly.","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}为什么会发生
- 你的密钥所属账户的速率或并发上限被超出。使用自定义密钥时,Cursor 自己的套餐限制不参与——这是你密钥的额度。
- 代理运行和多个忙碌的聊天标签页同时发送请求,加起来触达上限。
- 同一把密钥还被其他工具或同事共用,他们的流量计入同一个上限。
- 第一个 429 之后的连续快速重试让窗口一直处于满载。
如何解决
- 在同一把密钥上同时运行更少的代理任务和聊天。
- Cursor 长时间运行时,暂停共用这把密钥的其他工具。
- 重试前等待 Retry-After 给出的间隔;频繁的手动重试只会延长这种状态。
相关搜索
cursor rate limit exceeded custom api keycursor 429 custom api key
常见问题
这是 Cursor 的快速请求额度限制吗?+
不是。使用自有密钥时,请求完全绕过 Cursor 的套餐计量。429 来自你密钥背后的端点。
为什么代理运行比聊天更容易撞上 429?+
一次代理运行会接连发送很多请求,而且常常是并行的,所以它比单个聊天更早触达速率或并发上限。
升级 Cursor 套餐有用吗?+
对这个错误没用。上限属于 API 密钥背后的账户。减少并行用量,或等待 Retry-After 给出的间隔。
全部 Cursor 错误 · API 错误码 · 配置指南