Gemini API 오류 코드

Troubleshooting guide  |  Gemini API  |  Google AI for DevelopersGoogle AI for Developers

오류 코드
400	INVALID_ARGUMENT 요청 본문이 잘못된 형식입니다.	다음 항목을 확인하세요: API 참조 요청 형식, 예시 및 지원되는 버전에 대해. 더 새로운 API 버전의 기능을 구형 엔드포인트와 함께 사용하면 오류가 발생할 수 있습니다.
400	FAILED_PRECONDITION Gemini API 무료 등급은 귀하의 국가에서 사용하실 수 없습니다. Google AI Studio에서 프로젝트에 결제를 활성화해 주세요.	Gemini API를 사용하려면 다음을 사용하여 유료 요금제를 설정해야 합니다 Google AI Studio.
403	PERMISSION_DENIED 귀하의 API 키에 필요한 권한이 없습니다.	API 키가 설정되어 있고 올바른 접근 권한이 있는지 확인하세요. 튜닝된 모델을 사용하려면 적절한 인증 절차를 거쳤는지도 확인하세요.
404	NOT_FOUND 요청한 리소스를 찾을 수 없습니다.	모든 요청의 매개변수가 유효한지 API 버전에 대해 확인하세요.
429	RESOURCE_EXHAUSTED 요청 수 한도를 초과했습니다.	모델의 요청 속도 제한. 쿼터 증액을 요청하세요 필요한 경우.
500	INTERNAL Google 측에서 예기치 않은 오류가 발생했습니다.	입력 컨텍스트를 줄이거나 일시적으로 다른 모델(예: Gemini 1.5 Pro에서 Gemini 1.5 Flash로)로 전환해 작동하는지 확인해 보세요. 또는 잠시 기다렸다가 요청을 다시 시도하세요. 재시도 후에도 문제가 지속되면 Google AI Studio의 피드백 보내기 버튼을 통해 보고해 주세요.
503	UNAVAILABLE 서비스가 일시적으로 과부하 상태이거나 중단되었을 수 있습니다.	일시적으로 다른 모델(예: Gemini 1.5 Pro에서 Gemini 1.5 Flash로)로 전환해 작동하는지 확인해 보세요. 또는 잠시 기다렸다가 요청을 다시 시도하세요. 재시도 후에도 문제가 지속되면 Google AI Studio의 피드백 보내기 버튼을 통해 보고해 주세요.
504	DEADLINE_EXCEEDED 서비스가 기한 내에 처리를 완료할 수 없습니다.	이 오류를 피하려면 클라이언트 요청에서 'timeout'을 더 크게 설정하세요.