疑难排查 · 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 key
  • cursor 429 custom api key

常见问题

这是 Cursor 的快速请求额度限制吗?+
不是。使用自有密钥时,请求完全绕过 Cursor 的套餐计量。429 来自你密钥背后的端点。
为什么代理运行比聊天更容易撞上 429?+
一次代理运行会接连发送很多请求,而且常常是并行的,所以它比单个聊天更早触达速率或并发上限。
升级 Cursor 套餐有用吗?+
对这个错误没用。上限属于 API 密钥背后的账户。减少并行用量,或等待 Retry-After 给出的间隔。

跳过折腾坏掉的配置

apiToken.sale 通过 OpenAI 兼容端点、Messages(Anthropic 格式)端点和原生 Gemini 端点提供 GPT 与 Gemini 模型——标准 SDK、一把密钥、一个预付余额。把你工具的 base URL 指向它,本页的配置即可原样生效。