제미나이 무료 API, 키 발급, 분당·일일 한도, 유료 전환 | 사이드 프로젝트 체크리스트는?
제미나이(Gemini) 무료 API 키 발급부터 분당·일일 요청 한도 확인, 사이드 프로젝트 일일 예산, 429 대응, AI 스튜디오 유료 연동과 Vertex 선택, 원화·부가세 손익 계산까지 체크리스트로 정리한다. 구글 AI 스튜디오 키·무료 티어·LLM·개발자·API·SDK 운영 점검 목록과 FAQ를 한 장에 모았다.
제미나이(Gemini) 무료 API 키는 구글 AI 스튜디오에서 카드 없이 발급되고, 한도는 분당 요청·분당 토큰·일일 요청 중 하나라도 넘기면 429로 막힙니다. 사이드 프로젝트를 무료로 돌리려면 “키 받기”보다 한도 확인 → 일일 예산 잡기 → 429 대응 → 유료 전환 신호 순서로 체크하는 편이 안전합니다. 한도와 단가는 모델·티어마다 달라서, 아래 목록을 통과한 뒤 AI Studio Rate Limit 화면 숫자를 최종 기준으로 쓰세요.
키를 만들기 전에 경로만 먼저 고릅니다. 잘못된 경로로 가면 Vertex 프로젝트 세팅에 하루를 쓰거나, 반대로 무료 키로 운영 트래픽을 태워 429 폭풍을 맞습니다.
질문
예 → 경로
아니오 → 경로
프로토타입·개인 도구·일 호출 수백 건 이하?
AI 스튜디오 무료 키
유료 티어(결제 연동) 검토
사용자 트래픽이 피크에 몰리는 서비스?
유료 + 큐·백오프 필수
무료 + 배치·캐시로 충분할 수 있음
학습 데이터 활용 정책이 민감한 데이터?
유료 약관·엔터프라이즈 경로 확인
무료 약관 고지 후 프로토타입 가능
조직 보안·VPC·감사 로그 필요?
Vertex·클라우드 경로
개발자 API(키 기반)로 시작
이미지·실시간·프리뷰 모델 필수?
모델별 무료 여부 표 확인
Flash·Flash-Lite 텍스트부터
무료 티어는 입력·출력 토큰 요금이 0원이지만, 한도는 프로젝트 단위로 잡힙니다. 키를 여러 개 만들어도 같은 프로젝트면 RPM·RPD가 합산됩니다. 공식 설명은 Rate limits 문서에 있습니다.
빠른 판정 — “지금 당장 카드 없이 호출 테스트”면 무료. “유료 사용자 앞에 SLA를 걸 예정”이면 결제 연동(Tier 1)부터 설계하세요. 중간 지대(베타 소수 사용자)는 무료 + 일일 캡 + 대기열로 버틸지 먼저 숫자로 재보세요.
무료 API 키 발급 체크리스트 | 5분 안에 끝내기
발급 자체는 짧습니다. 막히는 지점은 대개 프로젝트 연결·키 노출·환경 변수입니다. 순서대로 체크하고 다음으로 넘어가세요.
발급 직후 최소 호출 (Node, 환경 변수)
// npm i @google/genai
import { GoogleGenAI } from '@google/genai';
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const res = await ai.models.generateContent({
model: 'gemini-2.5-flash',
contents: '한 문장으로 자기소개해 줘',
});
console.log(res.text);
SDK 패키지명·모델 ID는 시기마다 바뀝니다. 설치 문서와 모델 목록은 공식 사이트를 기준으로 하고, 위 스니펫은 “키가 살아 있는지”만 확인하는 용도입니다. 프로덕션 모델명은 배포 전에 한 번 더 고정하세요.
무료 키는 AI 스튜디오에서 발급하고, 한도는 프로젝트 단위로 Rate Limit 화면에서 확인한다
무료 티어 한도 체크리스트 | RPM·TPM·RPD 읽기
구글 문서 기준으로 한도는 보통 세 갈래로 측정됩니다. 하나라도 초과하면 요청이 거절됩니다. 일일(RPD) 리셋은 태평양 시간 자정 기준입니다. 구체 숫자는 모델·사용 티어·계정 상태에 따라 달라서 문서에 고정 표를 박아 두지 않고, 확인 절차를 체크리스트로 둡니다.
지표
의미
사이드 프로젝트에서 흔한 사고
RPM
분당 요청 수
루프·재시도 폭주, 웹훅 동시 처리
TPM
분당 입력 토큰
긴 문서·대화 이력 통째 전송
RPD
일일 요청 수
크론이 밤새 돌아 아침부터 차단
IPM 등
이미지 등 모델별 추가 한도
텍스트 한도는 남았는데 이미지 막힘
사용 티어 — Free → 결제 연동 시 Tier 1 → 누적 결제·일수 조건으로 Tier 2·3. 티어가 오르면 한도가 커집니다. 조건은 공식 Rate limits의 Usage tiers 표를 따르고, 승급은 보통 자동입니다. “키만 여러 개”로 Free 한도를 늘리려 하지 마세요. 같은 프로젝트면 합산입니다.
사이드 프로젝트 일일 예산 | 무료로 버티는 패턴
1인 개발 사이드 프로젝트에서 무료 티어가 깨지는 패턴은 거의 같습니다. 사용자 한 명당 호출이 과하거나, 백그라운드 잡이 한도를 먼저 먹습니다. 아래는 “기능은 살리되 요청 수를 줄이는” 점검 목록입니다.
대략 감각만 잡자면, 하루 수백 건 수준의 내부 도구·배치 요약은 무료로 버티는 사례가 많고, 공개 서비스에서 동시 접속이 붙으면 RPM이 먼저 터집니다. 숫자 확정은 반드시 Rate Limit 화면 캡처 후 스프레드시트에 적어 두세요. 비슷한 한도 사고 사례는 무료 vs 유료 전환 케이스·스프린트 팀 한도 선택에도 정리돼 있습니다.
일일 RPD와 분당 RPM을 여유 있게 잡고 캐시·큐로 피크를 깎는 것이 무료 운영의 기본
429·한도 초과 대응 체크리스트 | 끊기지 않게
429 RESOURCE_EXHAUSTED 가 뜨면 “서버가 죽었다”가 아니라 내 한도 또는 일시 용량 신호일 때가 많습니다. 유료 티어에서도 spend-based 한도(10분 창)가 있으면 같은 코드로 막힐 수 있습니다.
단순 지수 백오프 스케치 (의사코드)
async function callWithBackoff(fn, { max = 5 } = {}) {
let delay = 1000;
for (let i = 0; i < max; i++) {
try {
return await fn();
} catch (e) {
const status = e?.status || e?.code;
if (status !== 429 && status !== 503) throw e;
if (i === max - 1) throw e;
const jitter = Math.floor(Math.random() * 250);
await new Promise(r => setTimeout(r, delay + jitter));
delay = Math.min(delay * 2, 30000);
}
}
}
유료 전환 신호 체크리스트 | 언제 카드를 연결하나
무료가 “영원히 0원”이 아니라 “한도 안의 0원”입니다. 아래 중 2개 이상이 2주 연속이면 결제 연동을 검토할 타이밍입니다. 앱 구독(구글 AI Pro 등)과 API 종량제는 별개 청구입니다.
전환 경로도 갈라집니다. 개발자 API 유료(AI Studio 결제 연동)는 기존 키 흐름을 유지한 채 한도·기능을 올리는 쪽이고, Vertex AI는 클라우드 프로젝트·IAM·리전·감사에 맞춰 운영하는 쪽입니다. 1인 사이드면 전자, 조직 규정·VPC면 후자를 먼저 표로 비교하세요.
항목
AI 스튜디오 개발자 API
Vertex AI 쪽
시작
API 키, 빠른 프로토타입
GCP 프로젝트·권한·할당량
무료
Free 티어 한도 내 0원
크레딧·프로모 제외 시 종량
한도 상향
티어 승급·한도 신청
할당량·프로비저닝 옵션
적합
1인·스타트업 MVP
기업 보안·멀티 서비스
유료 전환은 한도 부족 신호 2개 이상이 쌓일 때, 원화·부가세까지 넣고 월 예산을 적어 보고 결정한다
원화·부가세 손익 체크리스트 | 전환 전 계산 순서
단가는 보통 100만 토큰당 달러로 공시됩니다. 카드 청구는 환율·해외 수수료·부가세(VAT 10%) 조합이 붙을 수 있어, “공식 달러 × 환율”만으로 끝내면 실제 출금과 어긋납니다. 아래 순서로 스프레드시트 한 장만 만들면 됩니다.
주의 — 위 달러 예시는 계산 방법을 보여 주기 위한 골격입니다. 모델 단가·무료 제공 여부는 수시로 바뀌고, 프리뷰 모델은 무료 칸이 “Not available”인 경우도 있습니다. 배포 전 공식 Pricing을 다시 열어 숫자를 덮어쓰세요.
보안·운영 체크리스트 | 키 유출·약관·관측
무료라서 느슨해지기 쉬운 부분입니다. 키 하나 유출되면 한도 소진·악의적 호출·계정 제재로 이어질 수 있습니다.
배포 직전 최종 체크 | 한 장으로 끝내기
이 목록을 통과하면 “무료 API로 사이드 돌리기”의 사고 대부분이 줄어듭니다. 한도 숫자는 외우지 말고, 확인 습관과 피크 여유를 코드에 박아 두는 쪽이 오래 갑니다.
