문제 해결 · Zed

Zed 어시스턴트 429 rate_limit_error 해결

Zed 어시스턴트의 429는 키 뒤 계정의 요청 속도 또는 동시성 한도입니다. 에이전트 스레드와 공유 키가 왜 이를 유발하는지, 무엇이 이를 해소하는지.

표시되는 내용

HTTP 429
{"error":{"message":"Rate limit reached. Please retry shortly.","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}

발생 원인

  • 키가 속한 계정의 요청 속도 또는 동시성 한도를 넘었습니다 — 에이전트 스레드는 여러 요청을 연달아 보냅니다.
  • 같은 키를 다른 도구가 동시에 쓰고 있어, 그 트래픽이 같은 한도를 나눠 씁니다.
  • 포화된 창 안에서의 재시도는 창을 계속 포화 상태로 유지합니다.

해결 방법

  • Retry-After 간격만큼 기다린 뒤 계속하세요 — 429 한 번에는 설정 변경이 필요 없습니다.
  • 한 키에서 동시에 실행하는 어시스턴트 스레드 수를 줄이세요.
  • 긴 실행 중에는 같은 키를 쓰는 다른 도구를 멈추세요.

관련 검색어

  • zed assistant 429

자주 묻는 질문

이것은 Zed의 한도인가요, 제 키의 한도인가요?+
키의 한도입니다. Zed는 자체 계량을 더하지 않으며, 429는 설정된 키 뒤의 계정에서 옵니다.
에이전트 스레드가 상황을 왜 더 나쁘게 만드나요?+
에이전트 스레드는 단계마다, 흔히 연달아 요청을 보냅니다. 보이는 질문이 짧아도 요청 속도는 작업량과 함께 늘어납니다.
즉시 재시도하면 도움이 되나요?+
아니요 — 즉시 재시도는 창을 포화 상태로 유지합니다. 짧게 쉬면 해소됩니다.

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

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