속도 제한 429 api proxy

Error 429 Too Many Requests

429가 반복되면 보통 업스트림 계정 풀이 속도 제한 중이거나, 쿨다운 중이거나, 사용 가능한 쿼터를 소진한 상태입니다. 먼저 서비스 운영자에게 계정, 라우트, 모델 전환을 요청한 뒤, 최소 요청으로 로컬 동시 실행, 잔액, 재시도 루프 문제를 가려내세요.

요약

Error: exceeded retry limit, last status: 429 Too Many Requests, request id: <request-id>. AI API 중계 서비스에서 429가 반복되면 보통 업스트림 계정 풀이 속도 제한 중이거나, 쿨다운 중이거나, 사용 가능한 쿼터를 소진한 상태입니다. 먼저 서비스 운영자에게 계정, 라우트, 모델 전환을 요청하세요.

#error 429 #429 too many requests #openai api 429 #claude code 429 #codex 429 #exceeded retry limit 429

429 Too Many Requests 오류의 의미

429 Too Many Requests는 요청의 기본 형식은 받아들여졌지만, 쿼터나 속도 한도에 도달해 지금은 처리를 거절했음을 뜻합니다.

AI API 중계 서비스에서는 같은 API 키로 재시도하기 전에 서비스 쪽 업스트림 계정 풀을 확인하세요. 그 풀이 쿨다운 중이거나 소진된 상태면, 재시도를 반복할수록 429만 늘어납니다.

주요 원인

중계 서비스의 업스트림 계정 풀이 속도 한도에 도달했거나, 쿨다운에 들어갔거나, 사용 가능한 쿼터를 잃었습니다.
현재 모델 라우트에 유효한 과금 여유가 없거나, 모델별 한도에 도달했거나, 이용 가능한 정상 업스트림 계정이 없습니다.
다른 계정 풀이나 업스트림 공식 API에 여유가 있어도, 중계 서비스가 사용 중인 키를 속도 제한하고 있습니다.
Claude Code, Codex, Cursor 같은 도구가 실패한 호출을 재시도해, 한 번의 실패를 짧은 시간에 여러 요청으로 키웁니다.
긴 컨텍스트, 스트리밍 작업, 배치 처리, 코딩 에이전트 루프가 예상보다 빠르게 토큰을 소비합니다.

AI API 중계 서비스에서 429를 진단하는 방법

같은 Base URL, API 키, 모델로 가능한 한 작은 요청부터 확인합니다. 이 요청도 429이면 쿼터, 과금, 서비스 한도, 프록시 쪽 스로틀링일 가능성이 큽니다.

최소 요청은 성공하고 코딩 도구만 실패하면, 에이전트 동시 실행 수를 줄이고 재시도 루프가 있는지 확인하세요. 코딩 에이전트는 파일을 읽고, 도구를 호출하고, 실패한 단계를 복구하는 동안 작은 요청을 빠르게 많이 보낼 수 있습니다.

AI API 중계 서비스에서 429를 해결하는 방법

재시도 전에 기다립니다. 응답에 Retry-After 헤더가 있으면, 같은 요청을 바로 보내지 말고 그 시간만큼 기다리세요.
서비스 대시보드에서 잔액, 과금 상태, 일일 쿼터, 요청 한도, 모델별 제한을 확인합니다.
현재 플랜 또는 API 키의 동시 실행 한도를 확인한 뒤, 동시 실행 수와 최대 출력 토큰을 줄이고 프롬프트를 짧게 하세요. 같은 API 키로 코딩 에이전트 세션을 여러 개 동시에 돌리지 마세요.
최소 요청은 성공하는데 현재 Claude Code, Codex, Cursor 세션에서만 429가 계속되면, 작업을 멈추고 잠시 기다린 뒤 새 채팅이나 새 세션에서 다시 시도하세요.
429가 계속되면 발생 시각, 모델 이름, Base URL, 클라이언트 도구, 오류 메시지 전체를 첨부해 지원에 연락하고, 계정 풀 용량, 쿼터, 라우트 단위 스로틀링을 확인해 달라고 요청하세요.