요청 문제 해결

AI API 오류: 401, 429, 5xx 및 시간 초과

OpenAI, Claude, Gemini API의 인증, 할당량, 요청 제한 및 일시적 실패를 구분하세요. 재시도 결정 전에 상세를 확인하세요.

작성자: IsAnythingDown검토일 2026-10-06Markdown 읽기 ↗

간단한 답변

API 오류만으로 제공업체 장애가 입증되지는 않습니다. 오류 본문과 요청 ID를 확인하고 해당 상태 구성 요소를 점검하세요. 인증 및 결제 문제에는 설정 변경이 필요하며 일시적 실패는 제한된 재시도를 정당화할 수 있습니다.

오류 유형부터 확인

표로 첫 검사를 선택하세요. 정확한 의미/대응은 제공업체, 엔드포인트 및 오류 본문에 따라 다릅니다.

표시 내용	첫 검사	입증하지 못하는 것
400 / 404 / 413	요청 형식, 엔드포인트, 리소스 및 크기. 제공업체 오류 확인	일반적인 서비스 장애
401 / 403	자격 증명, 접근 권한 및 제공업체별 제한	모든 사용자가 차단됨
429	제한 헤더, 할당량, 크레딧 및 지출 한도	즉시 재시도하면 작동함
500 / 503 / 529	제공업체 오류 상세 및 해당 공식 구성 요소	확인된 전 세계 사고
시간 초과 / 연결 오류	클라이언트 제한 시간, DNS, TLS, 프록시 및 요청 기간	실패를 유발한 쪽

OpenAI: 429는 여러 제한을 뜻할 수 있음

HTTP 429만 보지 말고 error.code를 확인하세요. OpenAI는 요청 속도 제한과 크레딧 소진, 조직/프로젝트 한도를 구분합니다. 결제 및 할당량 실패는 반복 재시도로 해결되지 않습니다. 일시적 제한 및 과부하에는 Retry-After를 준수하고 재시도를 제한하세요.

API 구성 요소는 OpenAI API 항목을 사용하세요. ChatGPT 앱 항목은 API 결과나 특정 GPT 모델 상태를 확인하지 못합니다.

Claude: 과부하와 지출 한도는 다름

Claude는 529를 과부하, 401을 인증 실패, 403을 권한 실패로 정의합니다. 429는 요청 제한 또는 지출 한도일 수 있습니다. 사용 등급 지출 한도 429에는 Retry-After 헤더가 없으며 접근 재개 전까지 계속 실패합니다. 재시도 정책 선택 전 전체 오류를 읽으세요.

Claude 문서상 HTTP 200 이후 스트리밍 오류가 발생할 수 있습니다. 완료 및 오류 이벤트를 확인하세요. 헤더 수신만으로 생성 성공이 입증되지는 않습니다.

Claude API 오류 ↗

Gemini: 개발자 엔드포인트 확인

Google은 일시적 실패에 제한된 지수 백오프 및 임의 지연을 권장합니다. API 버전, 모델, 지원 매개변수도 확인하세요. 개발자 API 자체 보고를 참조하세요. Gemini 앱 사고 피드는 Gemini API 또는 AI Studio 요청을 포함하지 않습니다.

재시도 한도 설정

애플리케이션 설계상 최대 시도 횟수와 총 시간 한도를 모두 설정하세요. SDK가 이미 수행한 재시도를 고려하세요. 제공업체가 일시적이라고 정의한 오류에는 지수 백오프와 임의 지연을 사용하고 해당 재시도 헤더를 준수하세요.

중단된 요청을 재실행하기 전에 출력, 과금, 후속 동작이 이미 발생했는지 확인하세요. 모델 요청 재시도와 에이전트 도구 동작 반복은 별개의 결정입니다. 문제 해결을 위해 요청 ID를 보존하고 허용 한도 소진 시 자동 재시도를 중단하세요.

특정 응답 문제 해결

요청 오류 전용 안내를 사용하세요. 요청 실패 설명이며 계정 한도 모니터링이 아닙니다.