AI API 오류 429: 요청 제한, 크레딧 및 지출 한도
429는 요청 제한 응답이며 제공업체 장애의 증거가 아닙니다. 재시도 전에 제공업체 오류 코드, 메시지, 재시도 헤더를 확인하세요.
간단한 답변
429는 요청 제한 응답이며 제공업체 장애의 증거가 아닙니다. 재시도 전에 제공업체 오류 코드, 메시지, 재시도 헤더를 확인하세요.
제공업체별 문서 내용
OpenAI는 요청 속도, 크레딧 소진 및 조직/프로젝트 한도를 구분합니다. error.code를 확인하세요. 결제 또는 사용 한도 재시도는 접근을 복구하지 않습니다.
Claude는 요청 제한 및 일부 지출 한도에 rate_limit_error를 사용합니다. 사용 등급 지출 한도 응답에는 retry-after 헤더가 없습니다. 트래픽 급증도 요청 제한을 유발할 수 있습니다.
Gemini는 429 RESOURCE_EXHAUSTED를 지수 백오프가 적절할 수 있는 오류로 설명합니다. 제한을 일시적으로 취급하기 전에 오류 세부 사항을 확인하세요.
권장 앱 대응
일시적 요청 제한은 동시 요청을 줄이고 제공 지연을 준수하며 최대 횟수와 총 제한 시간을 설정하세요. SDK 재시도도 고려하세요. 재시도 헤더 부재만으로 원인을 식별하지 못합니다.
민감 정보를 제거한 오류 본문과 요청 ID를 보존하세요. 크레딧/지출 제한이면 계정 설정을 비공개로 확인하고 자격 증명은 공개하지 마세요. 해당 API 상태 범위와 요청 증거를 비교하세요.
관련 서비스 페이지
각 항목에 수집 범위가 표시됩니다. 링크된 서비스가 반드시 자동 수집되는 것은 아닙니다.
편집 검토일은 이 안내에 적용됩니다. 실시간 보고 수집 시각은 서비스 페이지에 표시됩니다.