얼마 전 사이드 프로젝트에 Gemini API를 붙이려다 갑자기 인증 오류가 났습니다. 키가 잘못된 건지, 한도를 넘긴 건지 처음엔 감도 안 잡혔어요. 찾아보니 정책이 꽤 많이 바뀌어 있더라고요. 특히 6월 19일 비제한 키 차단 일정이 코앞인데 모르고 지나치는 분들이 많을 것 같아서 정리해 봤습니다.
Google AI Studio에서 Gemini API 키 만들기
발급 자체는 단순합니다. aistudio.google.com에 구글 계정으로 로그인한 뒤, 왼쪽 사이드바나 상단 메뉴에서 "Get API key"를 클릭하면 됩니다. 신용카드 없이 바로 키가 발급되고, 발급된 키는 AIza로 시작하는 긴 문자열 형태예요.
키는 구글 클라우드 프로젝트에 연결됩니다. 처음 발급하면 Google이 자동으로 기본 프로젝트를 만들어 주는 경우가 많으니 별도로 설정할 필요는 없습니다. 발급 후에는 환경 변수(GEMINI_API_KEY)에 넣어두고 코드에서 불러오는 방식이 안전합니다. 소스코드에 직접 붙여 넣으면 나중에 깜빡하고 GitHub에 올리는 사고가 생기거든요.
주의할 점 하나. 쿼터는 API 키 단위가 아니라 프로젝트 단위로 계산됩니다. 같은 프로젝트 안에서 키를 여러 개 만들어도 한도가 늘어나지 않아요.
6월 19일 비제한 키 차단, 내 키가 해당되나요?
이게 지금 가장 급한 내용입니다. Google 공식 문서에 따르면, 2026년 6월 19일부터 비제한(unrestricted) 상태의 API 키는 Gemini API 요청을 차단합니다. 제한이 없는 키는 프로젝트에서 활성화된 모든 API에 접근할 수 있어서 보안상 문제가 됐기 때문입니다.
내 키가 해당되는지 확인하는 방법은 간단합니다.
- aistudio.google.com/api-keys로 접속합니다.
- 키 목록에서 "unrestricted" 표시가 있는 키를 찾습니다.
- 해당 키 옆의 "Restrict to Gemini API" 버튼을 클릭합니다.
이 버튼 하나로 Generative Language API 전용으로 제한이 걸립니다. 2026년 중 새로 AI Studio에서 발급한 키라면 이미 기본적으로 제한이 걸려 있을 가능성이 높습니다. 다만 예전에 Google Cloud Console에서 만든 키나 Maps, Firebase 등 다른 용도로 쓰던 키가 Gemini에도 연결된 경우라면 꼭 확인해야 합니다.
이 이슈가 생겨난 배경이 흥미롭습니다. 구글 클라우드는 오랫동안 API 키를 "공개해도 괜찮은 프로젝트 식별자"로 취급하도록 안내했는데, Gemini가 등장하면서 같은 키로 AI 요청도 보낼 수 있게 됐습니다. 결과적으로 Maps용으로 프런트엔드에 박아둔 키가 어느 날 갑자기 Gemini 인증 키가 돼버린 거예요. 보안 연구 결과 공개된 상태로 방치된 키가 실제로 수천 건에 달했다는 보고도 있습니다.
2026년 6월 기준 무료 한도 실제 현황
무료 티어가 있다는 건 맞는데, 작년과는 상황이 꽤 달라졌습니다.
공식 문서 기준으로 정리하면 이렇습니다. 2025년 12월 Google이 무료 티어 한도를 대폭 줄였고, 2026년 4월 1일부터는 Pro 계열 모델이 유료 티어로 이동했습니다. Gemini 2.5 Pro로 무언가 만들고 싶다면 결제 설정이 필요하다고 보면 됩니다.
현재 무료로 쓸 수 있는 모델은 Flash 계열입니다.
- Gemini 2.5 Flash 및 Flash-Lite: 분당 요청 수 제한이 있으며, 일 단위 쿼터도 적용됩니다.
- 무료 모델 공통: 최대 100만 토큰 컨텍스트 윈도우는 유지됩니다.
정확한 숫자는 Google 공식 rate limits 문서와 AI Studio 대시보드에서 본인 프로젝트 기준으로 확인하는 게 가장 정확합니다. 모델, 지역, 계정 상태, 사용 패턴에 따라 실제 한도가 다르게 표시될 수 있거든요.
제미나이 API 무료 사용법을 찾는 분들이 많은데, 숫자만 보면 여전히 나쁘지 않습니다. 하지만 한 가지 조심할 점이 있어요. 무료 프로젝트에 결제를 활성화하는 순간, 그 프로젝트의 무료 티어가 사라집니다. 첫 토큰부터 요금이 붙어요. 무료 테스트용과 유료 운영용은 프로젝트를 분리해 두는 게 낫습니다.
그리고 무료 티어에서는 API 입출력 내용이 Google의 모델 개선에 활용될 수 있습니다. 민감한 데이터를 다루는 프로젝트라면 유료 전환을 고려해야 하는 이유가 됩니다.
유료 전환, 생각보다 부담 없는 이유
Flash 계열 모델은 Pro에 비해 토큰 단가가 낮아서, 개인 프로젝트 수준이라면 한 달에 몇 달러 안 나오는 경우도 많습니다. 가격 수치는 모델 세대별로 다르고 자주 바뀌기 때문에 결제 전에 공식 pricing 페이지에서 최신 단가를 확인하는 게 안전합니다.
결제를 활성화하면 Tier 1으로 올라갑니다. 분당 요청 수가 무료 대비 크게 늘고, Pro 계열 모델도 쓸 수 있게 됩니다. 과금 방식은 공식 문서 기준 2026년 3월부터 Prepay와 Postpay로 나뉘었는데, Prepay는 미리 충전 후 차감 방식, Postpay는 월말 청구 방식입니다. Prepay를 선택하면 잔액이 0이 될 때 API가 멈추니 알림 설정을 해두는 게 좋습니다.
Tier 1에는 월 지출 상한이 설정돼 있어서, 코드 버그로 루프가 돌아도 무한 청구될 걱정은 없습니다. 상한 금액은 공식 billing 문서에서 확인할 수 있습니다.
Gemini API 유료 전환 방법은 AI Studio 좌측 메뉴의 "Get Gemini API Tier 1" 또는 Google Cloud Console에서 결제 계정을 연결하면 됩니다. 별도 심사 없이 즉시 전환됩니다.
결국 오류가 났던 이유는 비제한 키였습니다. 제한 설정 하나로 해결됐어요. 아직 확인 안 하셨다면 지금 바로 aistudio.google.com/api-keys 들어가서 확인해 보시길 권합니다. 6월 19일이 2주도 채 남지 않았거든요.
