오류코드
오류는 인증, endpoint, 요청량, 네트워크 순서로 좁히면 빠르게 원인을 찾을 수 있습니다. 제품을 선택해 확인하세요.
| 코드 | 의미 | 바로 확인할 것 |
|---|---|---|
400 | 요청 형식 오류 | model, messages, header 형식을 확인합니다. |
401 | 인증 실패 | ANTHROPIC_AUTH_TOKEN 값과 키 공백 여부를 확인합니다. |
403 | 권한 또는 정책 차단 | 키 상태, 플랜, 허용 모델 범위를 확인합니다. |
404 | 경로 오류 | endpoint가 https://api.letsfine.com/claude/v1 인지 확인합니다. |
408 | 요청 시간 초과 | 네트워크 상태와 요청 크기를 줄여 재시도합니다. |
429 | 요청량 제한 | 짧은 시간 반복 호출을 줄이고 백오프를 적용합니다. Retry-After 헤더가 있으면 그 시간만큼 기다리고, 없으면 1초→2초→4초 지수 백오프로 재시도합니다. |
500 | 서버 내부 오류 | 동일 요청 재시도 전 요청 ID와 시간을 기록합니다. |
502 | 상위 모델 게이트웨이 오류 | 잠시 후 재시도하고 장시간 지속되면 지원에 전달합니다. |
503 | 일시적 사용 불가 | 서비스 상태 또는 모델 혼잡 가능성을 확인합니다. |
504 | 게이트웨이 시간 초과 | 긴 컨텍스트를 줄이고 재시도 간격을 둡니다. |
그래도 해결되지 않으면 1:1 문의로 오류 코드와 발생 시각을 알려주세요.
Gemini 연결 문제
구매가 준비 중이면 API 사용 가능 상태로 간주하지 마세요. 사용 가능 상태에서 401/403은 Gemini 키와 인증 헤더, 404는 해당 endpoint와 공개 모델 ID, 429는 잔액·사용 제한과 재시도 간격을 확인하세요. HTTP 5xx는 외부 서비스 상태를 확인하고, 같은 요청을 무한 재시도하지 마세요. 문의에는 키 대신 요청 ID와 상태 코드만 전달하세요.
이 문서가 도움이 되었나요?