문제 해결 · 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의 fast requests 한도인가요?+
아니요. 자체 키를 쓰면 요청이 Cursor 요금제 계량을 완전히 우회합니다. 429는 키 뒤의 엔드포인트에서 옵니다.
에이전트 실행이 채팅보다 429에 더 자주 걸리는 이유는?+
에이전트 실행은 많은 요청을 연달아, 그리고 자주 병렬로 보내므로 단일 채팅보다 먼저 요청 속도나 동시성 한도에 닿습니다.
Cursor 요금제를 업그레이드하면 도움이 되나요?+
이 오류에는 도움이 되지 않습니다. 한도는 API 키 뒤의 계정에 속합니다. 병렬 사용을 줄이거나 Retry-After 간격만큼 기다리세요.

잘못된 설정에 시간 낭비하지 마세요

apiToken.sale은 OpenAI 호환, Messages(Anthropic 형식), 네이티브 Gemini 엔드포인트로 GPT와 Gemini 모델을 제공합니다 — 표준 SDK, 하나의 키, 하나의 선불 잔액. 도구의 base URL만 지정하면 이 페이지의 설정이 적힌 그대로 작동합니다.