"제미나이 API를 써 보고 싶은데, 결제 카드를 등록해야 하나?" 파이썬 자동화를 처음 시작하는 분들이 가장 많이 묻는 질문입니다. 결론부터 말하면 구글 제미나이 API는 Google AI 스튜디오에서 무료로 사용할 수 있습니다. 다만 무료 API에는 모델별로 분당·일일 호출 횟수 제한이 있고, 어떤 모델은 무료 등급에서 아예 호출할 수 없습니다.
이 글은 필자의 AI 스튜디오 비율 제한(Rate limit) 화면에 표시된 무료 등급 한도를 그대로 옮기고, 구글 공식 문서(가격 책정·비율 제한·API 키 문서)를 함께 확인해 정리했습니다.
✅ 이 글에서 얻을 수 있는 것
1. 제미나이 무료 API 키를 발급하는 정확한 순서
2. 모델별 무료 한도(RPM·TPM·RPD)와 내 용도에 맞는 모델 고르기
3. 하루 한도 초기화 시각(한국 시간)과 429 오류를 피하는 코드
4. 무료 등급을 업무에 쓰기 전에 반드시 알아야 할 데이터 정책
구글 제미나이 API 무료 등급이란?
제미나이 API는 사용량에 따라 무료(Free) → Tier 1 → Tier 2 → Tier 3 등급으로 나뉩니다. AI 스튜디오에서 처음 API 키를 만들면 결제 계정이 연결되지 않은 무료 등급으로 시작하고, 결제 계정을 연결하면 Tier 1, 누적 결제 금액과 기간 조건을 채우면 상위 등급으로 자동 승급됩니다.
구글 공식 가격 문서는 무료 등급에 대해 다음 두 가지를 분명히 밝힙니다.
- Gemini 3.8 Flash, 3.7 Flash, 3.6 Flash, 3.5 Flash, 2.5 Flash, 2.5 Flash-Lite 등은 무료 등급에서 입력·출력이 무료(Free of charge) 입니다.
- Google AI 스튜디오 웹 화면에서의 사용은 지원 지역 어디서나 무료입니다.
즉 "제미나이 무료 API"는 체험판처럼 기간이 끝나는 것이 아니라, 횟수 제한 안에서 계속 무료로 쓸 수 있는 등급입니다.
제미나이 무료 API 키 발급 방법 (5단계)
- Google AI 스튜디오에 접속해 구글 계정으로 로그인합니다.
- 처음이라면 서비스 약관에 동의합니다. 이때 기본 프로젝트(Default Gemini Project)가 자동으로 생성됩니다.
- 대시보드 → 프로젝트에서 Create API key를 눌러 키를 만듭니다.
- 생성된 키를 복사해 환경 변수
GEMINI_API_KEY에 저장합니다. 구글 공식 SDK는 이 환경 변수를 자동으로 읽습니다. - 비율 제한 화면 에서 프로젝트가 '무료 등급'인지, 모델별 한도가 얼마인지 확인합니다.
공식 문서는 API 키를 "비밀번호처럼 다루라" 고 안내합니다. 깃허브 같은 저장소에 키를 올리거나, 웹페이지 자바스크립트에 키를 직접 넣으면 남이 내 한도를 소진할 수 있습니다. 자동화 스크립트에서는 키를 코드에 쓰지 말고 .env 파일이나 환경 변수로만 불러오는 습관을 들이세요.
모델별 무료 한도 총정리 (RPM·TPM·RPD)
아래 표는 필자 계정의 AI 스튜디오 비율 제한 화면(무료 등급, Default Gemini Project) 에 2026년 10월 표시된 값입니다. 한도는 세 가지 기준으로 동시에 적용되며, 하나라도 넘으면 오류가 발생합니다.
- RPM(Requests Per Minute): 분당 요청 수
- TPM(Tokens Per Minute): 분당 입력 토큰 수
- RPD(Requests Per Day): 하루 요청 수
| 모델 | RPM | TPM | RPD | 한 줄 평 |
|---|---|---|---|---|
| Gemini 3.8 Flash | 5 | 250K | 20 | 최신 성능, 하루 20회라 테스트용 |
| Gemini 3.7 / 3.6 / 3.5 Flash | 5 | 250K | 20 | 3.8 Flash와 같은 한도 |
| Gemini 3 Flash, 2.5 Flash | 5 | 250K | 20 | 같은 한도, 굳이 구버전을 쓸 이유는 적음 |
| Gemini 3.5 Flash Lite | 15 | 250K | 500 | 무료 자동화의 주력 모델 |
| Gemini 3.1 Flash Lite | 15 | 250K | 500 | 3.5 Flash Lite와 같은 한도 |
| Gemini 2.5 Flash Lite | 10 | 250K | 20 | Lite인데 하루 20회로 낮음 |
| Gemma 4 26B / 31B | 30 | 16K | 14,400 | 호출 횟수는 가장 넉넉, 입력 토큰이 작음 |
| Gemini Embedding 1 / 2 | 100 | 30K | 1,000 | 문서 검색(RAG)용 벡터 생성 |
| Gemini 3.8 Flash TTS 등 | 3 | 10K | 10 | 음성 합성, 맛보기 수준 |
| Gemini 3.1 Pro, 2.5 Pro | 0 | 0 | 0 | 무료 등급에서 사용 불가 |
| 나노 바나나, Veo 3, Lyria 3 | 0 | 0 | 0 | 이미지·영상·음악 생성 유료 전용 |
이 밖에 실시간 음성 대화용 Live API 모델(Gemini 3.8 Live 등)은 RPM·RPD가 '무제한'으로 표시되고 TPM만 65K로 제한되며, Antigravity 에이전트는 60 RPM·100 RPD가 배정되어 있었습니다.
표에서 읽어야 할 핵심 3가지
- 'Flash'와 'Flash Lite'의 하루 한도 차이가 25배입니다. 최신 Gemini 3.8 Flash는 하루 20회, Gemini 3.5 Flash Lite는 하루 500회입니다. 매일 반복하는 자동화라면 Lite가 현실적인 선택입니다.
- Pro 모델과 생성형 미디어 모델은 0입니다. 제미나이 앱에서 쓰던 나노 바나나 이미지 생성을 API로 그대로 붙이려면 유료 등급이 필요합니다.
- 검색 그라운딩도 모델별로 다릅니다. 같은 화면의 '도구' 항목에서 Gemini 2.5의 Google 검색 그라운딩은 하루 1,500회였지만, Gemini 3 계열은 0으로 표시되었습니다. 최신 뉴스 검색이 필요한 무료 자동화라면 이 점을 먼저 확인하세요.
하루 한도는 언제 초기화될까? (한국 시간)
공식 비율 제한 문서에 따르면 하루 요청 수(RPD)는 미국 태평양 시간 자정에 초기화됩니다. 한국 시간으로 바꾸면 다음과 같습니다.
| 기간 | 태평양 시간 자정 = 한국 시간 |
|---|---|
| 서머타임 기간 (2026년 11월 1일 전까지) | 오후 4시 |
| 서머타임 종료 후 (2026년 11월 1일부터) | 오후 5시 |
한국 기준 '자정'이 아니라는 점이 중요합니다. 예를 들어 오후 3시에 하루 20회를 다 썼다면, 한두 시간만 기다리면 다시 쓸 수 있습니다. 매일 실행하는 자동화는 초기화 직후(오후 5시 이후) 로 예약해 두면, 낮에 테스트로 한도를 다 써도 자동화가 막히지 않습니다.
또 하나, 한도는 API 키가 아니라 프로젝트 단위로 계산됩니다. 같은 프로젝트에서 키를 여러 개 만들어도 무료 한도는 늘어나지 않습니다.
파이썬으로 무료 API 호출하기 (429 오류 대비 포함)
구글 공식 SDK는 google-genai 입니다. 2026년 10월 공식 빠른 시작 문서는 client.interactions.create() 방식을 기본 예제로 안내합니다.
pip install -U google-genai
아래 코드는 무료 등급에서 하루 500회를 쓸 수 있는 Gemini 3.5 Flash Lite로 여러 문장을 요약하는 예제입니다. 분당 15회(RPM) 한도에 걸리지 않도록 요청 사이에 5초 간격을 두고, 한도 초과(429) 오류가 나면 잠시 기다렸다 다시 시도합니다.
import os
import time
from google import genai
from google.genai import errors
# 환경 변수 GEMINI_API_KEY 를 자동으로 읽습니다 (코드에 키를 직접 쓰지 마세요)
client = genai.Client()
MODEL = "gemini-3.5-flash-lite" # 무료 등급: 15 RPM, 하루 500회
INTERVAL = 60 / 15 + 1 # 분당 15회 → 약 5초 간격
def ask(prompt, retries=3):
for attempt in range(retries):
try:
res = client.interactions.create(model=MODEL, input=prompt)
return res.output_text
except errors.APIError as e:
if e.code == 429: # 비율 제한 초과
wait = 30 * (attempt + 1)
print(f"한도 초과, {wait}초 후 재시도")
time.sleep(wait)
else:
raise
return None
articles = ["기사 본문 1 ...", "기사 본문 2 ...", "기사 본문 3 ..."]
for text in articles:
print(ask(f"다음 내용을 3줄로 요약해 줘:\n{text}"))
time.sleep(INTERVAL)
429 오류가 계속 난다면 다음 순서로 확인하세요.
- 비율 제한 화면에서 해당 모델의 RPD가 이미 다 찼는지 봅니다. 다 찼다면 재시도해도 소용없으니 초기화 시각(한국 시간 오후 4~5시)까지 기다리거나 다른 모델로 바꿉니다.
- RPD가 남아 있다면 RPM 또는 TPM 문제입니다. 요청 간격을 늘리거나, 긴 문서는 나눠서 보냅니다.
- 모델 한도가 0으로 표시된다면 무료 등급에서 쓸 수 없는 모델입니다(Pro, 이미지·영상 모델).
📌 함께 보면 좋은 가이드: 구글 Gemini API와 파이썬으로 매일 아침 최신 IT 뉴스 자동 크롤링 및 요약하기 — 이 글에서 발급한 무료 API 키로 바로 따라 할 수 있는 실전 자동화 예제
무료 등급을 쓰기 전 꼭 알아야 할 주의사항
1. 무료 등급 데이터는 구글 제품 개선에 쓰일 수 있습니다
구글 가격 문서의 비교표에는 무료 등급이 "제품 개선에 콘텐츠가 사용됨", 유료 등급이 "제품 개선에 사용되지 않음" 으로 명시되어 있습니다. 회사 내부 문서, 고객 개인정보, 계약서처럼 민감한 데이터는 무료 API로 보내지 않는 것이 원칙입니다. 업무 데이터를 다룬다면 결제 계정을 연결한 유료 등급을 쓰는 편이 안전합니다.
2. 서비스 운영용으로는 한도가 부족합니다
Gemini 3.8 Flash 기준 하루 20회는 한 사람이 테스트하기에도 빠듯한 양입니다. 여러 사용자가 쓰는 챗봇이나 웹 서비스에 무료 키를 연결하면 금방 한도에 걸립니다. 무료 등급은 학습, 프로토타입, 개인용 자동화에 쓰고, 서비스로 공개할 때 유료 등급으로 전환하는 흐름을 권합니다.
3. 한도는 수시로 바뀝니다
무료 등급 한도는 모델 출시와 정책 변경에 따라 자주 조정됩니다. 이 글의 숫자는 2026년 10월 기준이므로, 코드를 짜기 전 비율 제한 화면에서 내 프로젝트의 현재 값을 꼭 다시 확인하세요.
용도별 추천: 어떤 무료 모델을 쓸까?
| 하고 싶은 일 | 추천 무료 모델 | 이유 |
|---|---|---|
| 매일 뉴스·메일 요약 자동화 | Gemini 3.5 Flash Lite | 하루 500회, 15 RPM으로 여유 |
| 최신 모델 성능 테스트 | Gemini 3.8 Flash | 품질 우선, 하루 20회 안에서 |
| 짧은 분류·태그 달기 대량 처리 | Gemma 4 31B | 하루 14,400회, 단 입력은 짧게(16K TPM) |
| 사내 문서 검색(RAG) 실습 | Gemini Embedding 2 | 100 RPM, 하루 1,000회 |
| 이미지·영상 생성, Pro 추론 | (무료 불가) | 유료 등급 필요 |
권장하는 운영 방식은 개발 중에는 3.8 Flash로 프롬프트 품질을 확인하고, 매일 반복되는 실제 자동화는 3.5 Flash Lite로 돌려 한도 부담을 줄이는 것입니다.
💡 챗GPT·클로드와 비교해 어떤 AI를 주력으로 쓸지 고민된다면 챗GPT vs 제미나이 vs 클로드 완벽 비교! GPT-6 아스트라·Gemini 3.8·Claude 5.1 성능 분석을, OpenAI API 비용 구조가 궁금하다면 챗GPT 웹/앱 구독 vs OpenAI API 차이점 및 비용 구조를 함께 참고하세요.
맺음말
구글 제미나이 API는 AI 스튜디오에서 결제 수단 없이 무료로 시작할 수 있는, 지금 가장 문턱이 낮은 생성형 AI API입니다. 무료 API를 제대로 쓰려면 다음 세 가지만 기억하세요.
- 발급: AI 스튜디오에서 API 키를 만들고 환경 변수로 보관한다.
- 모델 선택: 반복 자동화는 하루 500회인 Flash Lite, 품질 테스트는 하루 20회인 Flash를 쓴다.
- 한도 관리: 하루 한도는 한국 시간 오후 4시(11월부터 오후 5시)에 초기화되고, 키가 아닌 프로젝트 단위로 계산된다.
공식 자료
- Google AI 스튜디오 비율 제한 화면 (로그인 필요)
- Gemini API 비율 제한 (Google AI for Developers)
- Gemini API 가격 책정 (Google AI for Developers)
- Gemini API 키 사용하기 (Google AI for Developers)
👉 다음에 읽을 글
- 구글 제미나이 윈도우 앱 출시! Gemini PC 다운로드 및 설치 방법 — API 없이 PC에서 바로 제미나이를 쓰고 싶다면
