진단 체크리스트
연결이 안 될 때는 아래 항목을 순서대로 확인해 보세요. 체크하면 다음 단계를 안내해 드려요.
- 오래된 버전은 설정 메뉴 위치가 다를 수 있어요.
- 구매내역에서 키 상태를 확인하세요.
- 설정 파일·환경 변수를 저장했는지 확인하세요.
- 설정은 재시작 후 적용되는 경우가 많아요.
- 플랜에 포함된 모델인지 확인하세요.
체크한 항목에 따라 다음 단계를 추천해 드려요.
증상이 구체적이라면 문제 해결 검색이 더 빠를 수 있어요.
Gemini 연결 문제
구매가 준비 중이면 API 사용 가능 상태로 간주하지 마세요. 사용 가능 상태에서 401/403은 Gemini 키와 인증 헤더, 404는 해당 endpoint와 공개 모델 ID, 429는 잔액·사용 제한과 재시도 간격을 확인하세요. HTTP 5xx는 외부 서비스 상태를 확인하고, 같은 요청을 무한 재시도하지 마세요. 문의에는 키 대신 요청 ID와 상태 코드만 전달하세요.
이 문서가 도움이 되었나요?