최종 업데이트: 2026-09-12
![]()
제미나이(Gemini) 오류는 구글 쪽 문제, 내 계정·한도 문제, 내 요청 문제 세 갈래로 나눠서 대처해요. 접속하자마자 “Something went wrong” 이 뜨면 구글 공식 도움말 기준으로 “현재 이 계정은 앱에 접근할 수 없음”이고 원인은 국가·나이·계정 종류예요. 쓰다가 멈추면 5시간·주간 사용량 한도이거나 구글 장애이고, Gemini API 를 쓰는 경우 429·503 은 지수 백오프로 재시도하되 400·401·403 은 요청과 키를 고쳐야 해요.
저는 클로드 Max 를 주력으로 쓰면서 제미나이 API 를 이미지 생성과 보조 판단에 붙여 써요. 클로드 오류 해결 방법, 클로드 사용량 한도에 이어 이번엔 제미나이를 Google 공식 도움말과 Gemini API 공식 문서 기준으로 정리했어요. 앱 사용자 파트와 개발자 파트를 나눴으니 해당하는 쪽만 봐도 돼요.
제미나이 오류, 누구 문제인지 30초 만에 구분하는 방법은?

구글 장애인지 확인하는 곳은 Google Workspace 상태 대시보드예요. 제품 목록에 “Gemini” 항목이 따로 있고 지난 장애 이력도 볼 수 있어요. 여기가 정상인데 나만 안 되면 계정·한도 문제이거나 요청 문제예요. 구글 문제는 기다리고, 계정 문제는 계정·플랜을 보고, 요청 문제는 요청을 고쳐요. 순서를 바꾸면 시간만 가요.
제미나이 앱 오류 문구 6가지, 원인과 대처는?
| 화면 문구·증상 | 원인 | 대처 |
|---|---|---|
| Something went wrong (접속·로그인 시점) | 공식 답변: “현재 이 계정은 앱에 접근할 수 없음”. 국가·나이·계정 종류 등 | 아래 계정 조건표 확인. 조건이 맞으면 잠시 후 재시도 |
| Something went wrong. Try again later (대화 중) | 일시 오류 또는 구글 장애 | 상태 대시보드 확인 후 몇 분 뒤 재시도. 새 대화로 다시 |
| Something went wrong (5) / (9) / (13) 처럼 숫자 붙음 | 공식 문서에 숫자별 설명 없음. 커뮤니티 스레드 다수 | 로그아웃 후 재로그인, 다른 계정으로 되는지 확인, 앱 업데이트·캐시 삭제 순서 |
| “사용량 한도에 가까워졌어요” / “한도에 도달했어요, ○시에 갱신” | 5시간 한도 또는 주간 한도 도달 | 표시된 시각까지 대기. 유료 구독이면 Flash-Lite 로 이어서 대화 가능 |
| 응답이 중간에 끊기거나 “도와드릴 수 없어요” | 안전 정책·저작권(recitation) 차단 | 표현을 바꿔 다시. 기다려도 풀리지 않음 |
| 직장·학교 계정에서 아예 안 보임 | 관리자가 Gemini 앱을 끔. 직장 계정은 18세 이상만 | 관리자에게 “Gemini 앱 켜기” 요청, 또는 개인 계정으로 |
숫자 붙은 오류는 공식 설명이 없어서 단정할 수 없어요. 계정을 바꿨을 때 되면 계정 문제, 안 되면 구글 쪽 문제로 가르는 것이 가장 빠른 구분법이에요.
제미나이 접속 자체가 막히는 계정 조건은?
공식 도움말 What you need to sign in to Gemini Apps 기준이에요.
| 계정 종류 | 조건 |
|---|---|
| 개인 Google 계정 | 13세 이상(국가별 기준 연령). Family Link 로 부모가 끌 수 있음 |
| 직장 계정 (Workspace) | 18세 이상 + 관리자가 Gemini 앱을 켜둔 상태 + 해당 라이선스 |
| 학교 계정 | 관리자가 켜둔 경우만 |
| 공통 | 지원 국가·언어여야 함. 구글은 “악용 이력이 없는 계정인지” 신호로 판단한다고 명시 |
마지막 줄이 함정이에요. 조건을 다 맞춰도 계정 신호 때문에 일시적으로 막힐 수 있다고 공식 문서에 적혀 있고, 이 경우 공식 답은 “나중에 다시 시도”뿐이에요. 새 계정을 급하게 만들기보다 하루 정도 두고 보는 것이 나아요. 직장 계정 관리자 설정은 Turn the Gemini App on or off에 있어요.
제미나이 사용량 한도는 언제 풀리고 플랜별로 얼마나 다른가요?
제미나이 앱 한도는 클로드와 구조가 같아요. 5시간마다 갱신되다가 주간 한도에 닿으면 멈춰요. 메시지 수가 아니라 “프롬프트 복잡도 + 사용한 모델·기능 + 대화 길이”로 계산하는 연산량 기준이에요. 출처는 Gemini Apps limits & upgrades for Google AI subscribers예요.
| 플랜 | 한도 | 컨텍스트(대화 길이) |
|---|---|---|
| 무료 | 기본 | 32K 토큰 |
| Google AI Plus | 기본의 2배 | 128K 토큰 |
| Google AI Pro | 기본의 4배 | 1M 토큰 |
| Google AI Ultra | Pro 의 5배 또는 20배 | 1M 토큰 |
- 내 한도와 갱신 시각: gemini.google.com 왼쪽 아래 설정 → 사용량 한도
- 한도에 가까워지면 알림, 도달하면 “언제 갱신되는지” 알림이 한 번 더 와요
- 유료 구독이면 한도 후에도 Flash-Lite 모델로 대화를 이어갈 수 있어요. 무료는 대기뿐
- 긴 대화 하나가 가장 비싸요. 주제가 바뀌면 새 대화가 답이에요
Gemini API 오류 코드 12개, 재시도해도 되는 것과 안 되는 것은?
공식 API errors 문서 기준이에요. 재시도할 것과 하면 안 되는 것을 먼저 가르세요.
| HTTP | 코드 | 뜻 | 대처 |
|---|---|---|---|
| 400 | invalid_request / parameter_unknown | 요청 형식·파라미터 오류 | 재시도 금지. API 레퍼런스와 대조, 모르는 파라미터 제거 |
| 400 | failed_precondition | 선행 조건 미충족(결제 비활성 등) | 무료 티어 미지원 국가·모델이면 결제 연결 |
| 401 | authentication | API 키 없음·잘못됨·만료 | 키 다시 발급, 환경변수 확인 |
| 403 | permission_denied | 키에 권한 없음 | 재시도 금지. AI Studio 에서 키·프로젝트 확인 |
| 404 | not_found / model_not_found | 리소스·모델명 없음 | 모델명 오타, 폐기된 모델이면 교체 |
| 429 | rate_limit_exceeded | 분당 요청·토큰 한도 초과(RPM·TPM) | 지수 백오프 재시도 |
| 429 | quota_exceeded | 일일 한도 초과(RPD) | 리셋 대기 또는 티어 올리기 |
| 429 | too_many_requests | 짧은 시간에 과다 요청 | 지수 백오프 재시도 |
| 500 | api_error | 서버 내부 오류 | 재시도, 계속되면 문의 |
| 503 | service_unavailable | 일시 과부하·다운 | 지수 백오프 재시도 |
| 504 | deadline_exceeded | 시간 안에 완료 못 함 | 클라이언트 타임아웃 늘리기, 입력 줄이기 |
| (응답 내) | safety / recitation / prohibited_content / spii / blocklist / language | 생성 차단 사유 | 프롬프트 수정. 재시도로 풀리지 않음 |

import time, random
from google import genai
from google.genai import errors
client = genai.Client() # GEMINI_API_KEY 환경변수
RETRY = {429, 500, 503, 504} # 이것만 다시 시도
for attempt in range(5):
try:
r = client.models.generate_content(model="gemini-2.5-flash", contents=prompt)
break
except errors.APIError as e:
if e.code not in RETRY: raise # 400·401·403·404 는 요청·키 문제
time.sleep(2 ** attempt + random.random()) # 1s → 2s → 4s → 8s → 16s
429 가 세 종류인 것이 핵심이에요. rate_limit_exceeded 는 1분만 쉬면 풀리고, quota_exceeded 는 그날은 끝이에요. 같은 429 라고 무조건 재시도 루프를 돌리면 일일 한도를 더 빨리 소진해요.
Gemini API 한도 구조와 무료 티어 제한은?
2026년 9월 2일 갱신된 공식 Rate limits 문서 기준이에요.
- 한도는 RPM(분당 요청) · TPM(분당 입력 토큰) · RPD(일일 요청) 세 축이고, 하나만 넘어도 429 예요
- 한도는 API 키가 아니라 프로젝트 단위예요. 키를 여러 개 만들어도 늘어나지 않아요
- 티어: 무료(결제 없음) → Tier 1(결제 연결) → Tier 2(누적 $100 + 3일) → Tier 3(누적 $1,000 + 30일)
- 모델별 실제 한도 숫자는 문서에 고정돼 있지 않고 AI Studio 에서 내 프로젝트 기준으로 확인해야 해요. 문서에 “보장되지 않으며 실제 용량은 달라질 수 있다”고 명시돼 있어요
트러블슈팅: 키는 되는데 특정 모델만 429
제가 2026년 8월에 실제로 겪은 사례예요. 키는 유효해서 텍스트 모델은 정상인데, 이미지 생성 모델만 무료 티어 쿼터가 0 이라 429 가 계속 났어요. 결제를 연결하면 바로 풀리는 구조라서 그때는 무료 대체 서비스로 폴백을 걸었어요. “키가 되는데 특정 모델만 429″라면 티어 문제로 보면 돼요.
자주 묻는 질문 (FAQ)
Q. 제미나이에서 Something went wrong 이 계속 뜨는데 뭐가 문제인가요?
접속 단계에서 뜨면 계정 조건(국가·나이·계정 종류·관리자 설정) 문제예요. 공식 답변은 “현재 이 계정은 접근 불가, 나중에 재시도”예요. 다른 계정으로 되면 계정 문제, 안 되면 상태 대시보드를 보세요.
Q. 제미나이 사용량 한도는 언제 풀리나요?
5시간마다 갱신되고, 주간 한도에 닿으면 주간 갱신 시각까지 기다려야 해요. 설정 → 사용량 한도에서 내 갱신 시각을 볼 수 있어요.
Q. 직장 계정인데 제미나이가 안 보여요.
관리자가 Gemini 앱을 끈 상태이거나 18세 미만 계정이에요. 관리자 콘솔에서 “Gemini 앱 켜기”를 해야 하고, 급하면 개인 계정으로 쓰세요.
Q. Gemini API 429 는 무조건 기다리면 되나요?
아니요. rate_limit_exceeded 는 잠깐 쉬면 되지만 quota_exceeded 는 일일 한도라 리셋까지 풀리지 않아요. 응답 본문의 코드를 보고 구분하세요.
Q. 무료 API 키인데 특정 모델만 오류가 나요.
무료 티어에서 쿼터가 0 인 모델(이미지 생성 등)이 있어요. 결제를 연결해 Tier 1 로 올리면 풀려요.
참고 자료
- What you need to sign in to Gemini Apps (Gemini Apps 도움말, “Something went wrong” 공식 설명)
- Gemini Apps limits & upgrades for Google AI subscribers (사용량 한도·플랜별 배수)
- Turn the Gemini App on or off (Workspace 관리자 도움말)
- Gemini API errors / Rate limits (2026-09-02 갱신)
- Google Workspace Status Dashboard (Gemini 장애 확인)
2026년 9월 12일 기준이에요. 한도와 오류 코드는 자주 바뀌니 막히면 공식 문서를 한 번 확인하세요. 클로드 쪽은 클로드 오류 해결 방법 2026과 클로드코드 윈도우 설치 오류 2026에 정리해뒀어요.

Leave a Reply