먼저 어디서 막혔는지부터 나눠 보세요
AI 스튜디오는 브라우저에서 프롬프트를 시험해 보는 "화면"과, 거기서 발급한 키로 내 코드에서 부르는 "Gemini API"가 한 몸처럼 붙어 있어요. 그런데 오류의 원인은 둘이 꽤 달라요. 화면이 열리지 않거나 계정 단계에서 튕긴다면 지역·나이·회사 계정 설정 문제일 가능성이 높고, 코드에서 숫자 오류 코드가 돌아온다면 한도·결제·키 문제인 경우가 대부분이에요.
- aistudio.google.com 접속 자체가 안 됨, "403 Access Restricted" → 아래 1번(지역·나이·회사 계정)
- 화면은 되는데 답 대신 "No Content" → 2번(안전 필터)
- 코드에서 429 RESOURCE_EXHAUSTED → 3번(요청·토큰·지출 한도)
- 403 PERMISSION_DENIED, 402, 프로젝트 상태가 Free tier unavailable·Payment needed·No credits → 4번(프로젝트·결제)
- 401, 키가 안 먹힘, "Create API key" 버튼이 비활성 → 5번(API 키)
- 구글 AI 프로를 구독했는데 API 요금이 따로 나옴 → 6번(구독과 API 결제의 차이)
1. 403 Access Restricted: 화면이 아예 안 열릴 때
공식 AI 스튜디오 문제 해결 문서는 403 Access Restricted를 "약관에 맞지 않는 방식으로 쓰고 있을 때" 뜨는 오류라고 설명하고, 가장 흔한 이유로 지원 지역이 아닌 곳에서 접속한 경우를 꼽아요. 대한민국(South Korea)은 공식 지원 지역 목록에 들어 있으니, 국내에서 평소처럼 접속했는데 막힌다면 아래 항목을 차례로 확인하는 게 빠릅니다.
지역: VPN과 코랩(Colab)을 의심하세요
해외 VPN이나 회사 프록시를 켠 상태라면 구글은 그 출구 위치를 기준으로 판단할 수 있어요. 특히 헷갈리는 게 구글 코랩이에요. 공식 문서는 코랩에서 API를 부를 때 지역 제한이 "내 위치"가 아니라 "코랩 인스턴스가 있는 지역" 기준으로 걸린다고 따로 적어 두었고, 코랩 셀에서 !curl ipinfo.io로 인스턴스 위치를 확인하라고 안내해요. 집에서는 되는데 코랩에서만 막힌다면 이 경우일 가능성이 높아요.
나이: 구글 계정이 만 18세 이상으로 확인돼야 해요
AI 스튜디오는 만 18세 이상만 쓸 수 있어요. 접속하려다 나이 요건 안내로 넘어간다면 ① 구글 계정의 생일 설정이 18세 이상인지, ② 계정에서 연령 인증을 마쳤는지, ③ 신분증으로 인증했다면 계정 생일과 신분증 생일이 같은지 확인하라는 게 공식 안내예요. 학교에서 받은 Google Workspace for Education 계정은 관리자 설정이 켜져 있어도 18세 미만이면 AI 스튜디오를 쓸 수 없고, 18세 이상으로 지정됐는지는 학교 관리자만 확인해 줄 수 있어요.
회사·학교 계정: 관리자가 꺼 둔 경우
Workspace 계정으로 들어갔는데 "We are sorry, but you do not have access to Google AI Studio. Please contact your Organization Administrator for access."라는 문구가 보이면 조직 관리자가 AI 스튜디오를 꺼 둔 상태예요. 공식 문서상 AI 스튜디오는 모든 Workspace 버전에서 기본으로 켜져 있지만, 관리자가 조직 단위로 끌 수 있어요. 이건 내가 해결할 수 없으니 관리자에게 요청하거나, 개인 계정으로 시험해 보는 수밖에 없습니다.
이 밖에도 구글 서비스 약관과 생성형 AI 추가 약관에 동의하지 않았거나, 자동 보안 검사를 통과하지 못했거나, 연결된 클라우드 프로젝트가 악용 신고로 표시된 경우에도 PERMISSION_DENIED나 접근 제한이 뜰 수 있다고 안내돼 있어요.
2. 답이 "No Content"로 비어 나올 때
AI 스튜디오 화면에서 응답 자리에 No Content만 보이면, 어떤 이유로든 결과가 차단된 거예요. 공식 문서가 알려주는 확인법은 간단해요. No Content 위에 마우스를 올린 뒤 Safety를 누르면 어떤 이유로 막혔는지 볼 수 있어요. 안전 설정 때문이라면 오른쪽 실행 설정(Run settings)에서 안전 설정을 조정할 수 있지만, 안전 설정과 무관하게 막혔다면 약관에 어긋나거나 지원되지 않는 요청일 수 있어서 프롬프트 자체를 바꿔야 해요.
API로 쓸 때는 오류 코드로 이유가 더 구체적으로 나와요. 공식 오류 목록에는 safety(유해 콘텐츠), recitation(저작권·원문 재현), language(지원하지 않는 언어), spii(민감한 개인정보) 같은 차단 코드가 있어요. 이런 코드는 재시도해도 같은 결과가 나오니 입력을 고친 뒤 다시 보내야 해요. 특히 recitation은 기존 글과 비슷한 결과가 나올 때 걸리는데, 공식 문서는 프롬프트와 맥락을 최대한 고유하게 만들라고 권해요.
3. 429 RESOURCE_EXHAUSTED: 한도에 걸렸을 때
429는 가장 자주 보는 오류인데, 같은 429라도 원인이 세 가지로 나뉘어요. 공식 오류 표 기준으로 정리하면 이렇습니다.
- rate_limit_exceeded / too_many_requests: 분당·초당 요청 수나 토큰 수를 넘은 경우. 잠깐 기다렸다가 간격을 늘려 재시도하면 풀려요.
- quota_exceeded: 하루 할당량(RPD)을 다 쓴 경우. 재시도해도 소용없고, 초기화될 때까지 기다리거나 한도를 올려야 해요.
- 지출 기반 한도: 유료 등급에서 10분 동안 쓴 금액이 등급별 상한(Tier 1은 10분당 10달러)을 넘은 경우. 잠시 기다리거나 긴 맥락·긴 출력 요청을 줄이라고 안내돼 있어요.
새 API 키를 만들어도 안 풀리는 이유
많이들 하는 실수가 키를 새로 만들어 한도를 우회하려는 거예요. 공식 문서는 한도가 "API 키별이 아니라 프로젝트별"로 적용된다고 분명히 적고 있어요. 같은 프로젝트 안에서 키를 몇 개 만들든 한도는 하나로 묶입니다.
하루 한도는 한국 시간으로 언제 풀리나요
하루 요청 한도(RPD)는 미국 태평양 시간 자정에 초기화돼요. 한국 시간으로 바꾸면 미국 서머타임 기간에는 오후 4시, 서머타임이 끝난 기간에는 오후 5시예요. 2026년에는 11월 1일(미국 시간)에 서머타임이 끝나서, 11월 2일 초기화부터 2027년 3월 중순까지는 오후 5시에 풀려요. 오전에 한도를 다 썼다면 그날 오후 5시 이후에 다시 시도하면 됩니다.
재시도는 이렇게
공식 권장은 지수 백오프예요. 처음엔 1초 정도 기다렸다가 2초, 4초, 8초처럼 간격을 늘리고, 여러 요청이 같은 순간에 몰리지 않도록 무작위 지연(jitter)을 섞고, 최대 재시도 횟수를 정해 두라고 해요. 공식 Python SDK는 이미 429와 5xx 오류에 대해 최대 4번, 처음 약 1초에서 최대 60초까지 늘려 가며 자동 재시도해요. 반대로 400·402·403은 재시도하면 안 되는 오류로 분류돼 있어요.
내 프로젝트의 실제 한도는 AI 스튜디오의 Rate limit 화면에서 볼 수 있어요. 한도는 모델마다 다르고, 미리보기(preview)·실험(experimental) 모델은 더 빡빡하다고 적혀 있으니, 미리보기 모델에서 자주 막힌다면 정식 모델로 바꿔 보는 것도 방법이에요. 구글 검색 그라운딩은 Gemini 3 이상 모델에서 프로젝트당 하루 1,500건이라는 별도 한도가 있어요.
4. 403 PERMISSION_DENIED·402: 프로젝트와 결제 문제
AI 스튜디오의 Projects 화면에서 프로젝트 상태가 Restricted, Free tier unavailable, Payment needed, Unavailable로 보이거나 API가 403을 돌려준다면 공식 문제 해결 문서의 "Project restricted or unavailable" 항목에 해당해요.
- Free tier unavailable: 모든 프로젝트가 무료 등급 대상은 아니에요. 자격은 프로젝트 단위로 판단되기 때문에 같은 프로젝트에서 키를 새로 만들어도 해결되지 않아요. 계속 쓰려면 결제 계정을 연결해 유료 등급으로 올려야 하고, 유료로 올려도 무료 할당량이 생기지는 않아요.
- Payment needed: 결제 계정에 미납 금액이 있거나 결제 수단에 문제가 있는 상태예요. AI 스튜디오 Billing 화면이나 Google Cloud 결제 콘솔에서 정리하면 접근이 자동으로 돌아와요.
- 키 유출로 차단: 403 메시지에 키가 유출됐다고 나오면 그 키는 다시 쓸 수 없어요. API Keys 화면에서 새 키를 만들고, 앞으로는 웹페이지 코드나 공개 저장소에 키를 넣지 마세요.
- 402 / No credits: 선불(Prepay) 잔액이 0이 된 상태예요. 크레딧을 충전하거나 자동 충전을 켜야 하고, 충전 전에는 재시도해도 성공하지 않아요.
유료 전환 절차도 바뀌었어요. 2026년 3월 23일부터 선불·후불 결제 방식이 적용됐고, 새 사용자는 기본적으로 선불이에요. 무료 등급에서 유료로 넘어가려면 결제 계정을 연결하고 최소 5달러를 선충전해야 하며, 한 번에 충전할 수 있는 최대 금액은 5,000달러예요. 선불 잔액이 0이 되면 그 결제 계정에 묶인 API 키가 모두 멈추고, 결제 집계에 약 10분 지연이 있어서 배치 작업처럼 오래 도는 작업은 잔액을 조금 넘겨 쓸 수 있다고 안내돼 있어요.
하나 더 알아둘 함정이 있어요. 모델 목록을 불러오는 models.list는 키가 존재하는지만 확인하기 때문에, 이 요청이 200으로 성공해도 실제 생성 요청이 된다는 보장은 없어요. "키 테스트는 통과했는데 생성만 403"이라면 키가 아니라 프로젝트 등급이나 결제 상태를 봐야 해요.
5. API 키가 안 먹힐 때
- 환경 변수 충돌부터 확인: 공식 SDK는 GEMINI_API_KEY와 GOOGLE_API_KEY를 자동으로 읽는데, 둘 다 설정돼 있으면 GOOGLE_API_KEY가 우선이에요. 예전에 다른 구글 서비스용으로 GOOGLE_API_KEY를 넣어 둔 적이 있다면, 새 Gemini 키를 넣어도 옛 키가 쓰이면서 401이나 403이 날 수 있어요.
- 제한 없는 표준 키는 거절: 2026년 5월 28일부터 AI 스튜디오에서 새로 만드는 키는 서비스 계정에 묶인 인증 키(auth key)로 만들어지고, Gemini API는 아무 제한도 걸지 않은 표준 키의 요청을 거절해요. 오래전에 Cloud 콘솔에서 만든 제한 없는 키를 쓰고 있다면 AI 스튜디오에서 새로 발급받는 게 가장 빠릅니다.
- "Create API key"가 비활성: "You do not have permission to create a key in this project"가 보이면 그 프로젝트에서 키를 만들 IAM 권한이 없는 거예요. 관리자에게 프로젝트 편집자 같은 역할을 요청하거나, 조직에 속하지 않은 새 프로젝트를 만들어 키를 발급하라는 게 공식 안내예요.
- 기존 클라우드 프로젝트가 안 보임: 이미 Google Cloud를 쓰던 계정은 기본 프로젝트가 자동으로 생기지 않아요. Dashboard → Projects → Import projects로 쓰려는 프로젝트를 가져온 다음 API Keys 화면에서 키를 만들어야 해요.
6. 구글 AI 프로를 구독했는데 API 요금이 따로 나와요
공식 Google AI plans 문서에 따르면 구글 AI 프로·울트라 구독은 AI 스튜디오의 플레이그라운드와 빌드 모드에서 더 높은 일일 할당량과 상위 모델(예: Gemini 4 Argon)을 열어 줘요. 하지만 이 혜택은 AI 스튜디오 웹 화면 안에서만 적용돼요. API 키로 내 앱이나 외부 프로그램에서 부르는 사용량은 구독과 별개로 Gemini API 등급에 따라 청구됩니다. 구글 원(Google One) AI 크레딧도 AI 스튜디오에서는 쓸 수 없어요. 또 AI 스튜디오 안의 딥 리서치·Antigravity 미리보기 같은 에이전트 기능은 구독에 포함되지 않고 유료 API 키가 필요하다고 적혀 있어요. 구독 후 화면에서는 잘 되는데 코드에서만 막힌다면 이 차이 때문일 가능성이 커요.
무료 등급과 유료 등급 비교 (2026-11-01 공식 문서 기준)
아래 표는 Gemini API 요금 한도·결제·요금 문서와 Google AI plans 문서에서 확인한 내용만 옮겼어요. 실제 분당·일일 한도 숫자는 모델과 계정 상태에 따라 달라서 문서에 고정값으로 나와 있지 않고, AI 스튜디오 Rate limit 화면에서 확인하도록 돼 있어요.
| 항목 | 무료 등급 | Tier 1 | Tier 2 / Tier 3 | 구글 AI 프로·울트라 구독 |
|---|---|---|---|---|
| 조건 | 활성 프로젝트 또는 무료 체험 | 결제 계정 연결 (선불 최소 5달러) | 누적 100달러 결제 + 첫 결제 후 3일 / 누적 1,000달러 + 30일 | 구글 AI 요금제 가입 |
| 요금 | 무료 (일부 모델만, 예: Gemini 3.8 Flash 입출력 무료) | 사용한 만큼. 예: Gemini 3.8 Flash 표준 입력 100만 토큰당 0.75달러, 출력 3.75달러 (2026-12-31까지, 2027년부터 각 1.50·7.50달러) | 구독료 (API 사용량은 별도 청구) | |
| 결제 등급 상한 | 해당 없음 | 250달러 | 2,000달러 / 2만~10만 달러 이상 | 해당 없음 |
| 10분당 지출 한도 | 해당 없음 | 10달러 | 50달러 / 200달러 | 해당 없음 (대신 AI 스튜디오 일일 할당량, 매일 초기화) |
| Gemini 4 Argon | 이용 불가 | 유료 이용 가능 | 유료 이용 가능 | AI 스튜디오 화면에서 이용 가능 |
| 입력·출력 데이터 활용 | 구글 제품 개선에 사용될 수 있음 | 제품 개선에 사용하지 않음 | 문서에 별도 표기 없음 | |
| 한국에서 이용 | 대한민국은 AI 스튜디오·Gemini API 공식 지원 지역 (만 18세 이상 계정) | |||
이런 분께 맞아요: 제미나이 앱보다 모델 설정을 직접 만지고 싶은 분, 무료 등급으로 프롬프트를 시험해 본 뒤 내 서비스에 API로 붙이려는 개발자·기획자에게 맞아요. 오류 메시지만 잘 읽으면 대부분 혼자서 원인을 좁힐 수 있게 문서가 정리돼 있어요.
안 맞아요: 만 18세 미만이거나 학교 계정만 있는 학생, 회사 기밀 문서를 넣어야 하는데 결제 계정을 붙일 수 없는 경우엔 맞지 않아요. 무료 등급 입력은 구글 제품 개선에 쓰일 수 있다고 명시돼 있기 때문이에요.
주의할 점: 한도는 프로젝트 단위, 등급과 결제 상한은 결제 계정 단위로 묶여요. 키를 여러 개 만들거나 프로젝트를 나눠도 같은 결제 계정이면 상한은 공유된다는 점을 기억하세요. 그리고 하루 한도 초기화 시각이 11월 2일부터 한국 시간 오후 4시에서 오후 5시로 한 시간 늦춰져요.
흔한 오류와 해결: 429 quota_exceeded는 기다리는 것 말고 방법이 없고, 429 rate_limit_exceeded는 간격을 늘려 재시도하면 풀려요. 402는 충전 전까지 재시도 금지, 403 Free tier unavailable은 새 키로 해결되지 않으니 결제 연결이 답이에요. 401이 계속되면 GOOGLE_API_KEY 환경 변수가 남아 있는지부터 보세요.
자주 묻는 질문
Q. 무료로 쓰다가 갑자기 429가 떠요. 결제하면 바로 풀리나요?
A. 무료 등급에서 결제 계정을 연결해 Tier 1로 올라가는 건 보통 즉시 반영된다고 안내돼 있어요. 다만 선불 방식이면 최소 5달러를 먼저 충전해야 하고, 이후 사용분은 모델별 요금대로 빠져나가요. 하루 한도 때문에 막힌 거라면 결제 없이 한국 시간 오후 5시(서머타임 기간엔 오후 4시)까지 기다려도 돼요.
Q. 키를 새로 만들었는데도 Free tier unavailable이 그대로예요.
A. 무료 등급 자격은 키가 아니라 Google Cloud 프로젝트 단위로 판단돼요. 같은 프로젝트 안에서 키를 바꾸는 건 효과가 없고, 그 프로젝트를 계속 쓰려면 결제 계정을 연결해 유료 등급으로 전환해야 해요.
Q. 구글 AI 프로 구독자인데 API 키로 Gemini 4 Argon을 부르면 막혀요.
A. 구독 혜택은 AI 스튜디오 웹 화면 안에서만 적용되고, API 키 사용은 별도의 Gemini API 등급과 결제를 따라요. 공식 요금표에서 Gemini 4 Argon은 무료 등급 이용이 불가로 표시돼 있으니, API로 쓰려면 결제를 연결한 유료 등급 프로젝트가 필요해요.
함께 보면 좋은 글
- 구글 '제미나이 4 아르곤' 공개…앱·AI 스튜디오·API로 지금 직접 써보는 법
- 딥시크(DeepSeek) 안 될 때: 402·429 오류와 로그인 문제 해결
- 제미나이 사용법: 캔버스·딥리서치까지
공식 문서 화면은 글 맨 아래에 모아뒀어요. 오류 코드 숫자보다 그 옆에 붙은 상태 이름(quota_exceeded, Free tier unavailable 등)을 먼저 읽으면 해결이 훨씬 빨라집니다.
이미지 출처: Google AI for Developers(ai.google.dev) Gemini API 공식 문서 직접 캡처 (AI 스튜디오 문제 해결, 사용 등급, 프로젝트 제한, Google AI 요금제)
최종 확인일: 2026-11-01
출처
Troubleshoot Google AI Studio
Gemini API troubleshooting
Gemini API errors
Gemini API rate limits
Gemini API billing
Gemini API pricing
Using Gemini API keys
Google AI plans in AI Studio
Available regions for Google AI Studio and Gemini API
Access Google AI Studio with your Workspace account
댓글
댓글 쓰기