Google Gemini API 키 발급 가이드

Google 계정만 있으면 AI Studio 또는 Google Cloud(Vertex AI)에서 바로 API 키를 만들 수 있습니다.
아래 순서대로 진행하면 프로젝트 생성 → API 키 발급 → 환경 변수 설정까지 한 번에 완료됩니다.
정책·쿼터는 수시로 변경될 수 있습니다. 운영 전 콘솔에서 현재 기준을 꼭 확인하세요.

사전 준비

Google 계정 : 개인/업무용 모두 가능
(선택) 결제 계정 : Vertex AI 경로 사용 시 필요
콘솔 경로 : aistudio.google.com / console.cloud.google.com

권한

AI Studio : Google 계정 로그인만으로 사용 가능
Vertex AI : 프로젝트 생성, 결제 연결, API 사용 설정, 필요 시 서비스 계정/역할 부여

발급 경로 안내

경로 A) AI Studio에서 발급(빠른 시작 · 권장)
1) AI Studio 접속 → Google 계정 로그인
2) 좌측 메뉴 API Keys / Keys & Usage → Create API key 클릭
3) 생성된 키를 복사하여 안전한 곳에 저장(시크릿/환경 변수)
4) 환경 변수 설정: GEMINI_API_KEY 또는 GOOGLE_API_KEY
5) SDK/HTTP로 간단 테스트(모델명, 파라미터 확인)

경로 B) Google Cloud Vertex AI에서 발급(운영/팀용)
1) Cloud Console → 새 프로젝트 생성
2) 프로젝트에 결제 계정 연결
3) Vertex AI API 사용 설정(Enable)
4) 필요 시 서비스 계정 생성 → 역할 부여(예: Vertex AI User)
5) API 키 생성 또는 ADC(애플리케이션 기본 자격) 구성
6) 서버 환경 변수/시크릿 매니저에 저장 → SDK/REST로 호출

참고: 동일 SDK로 AI Studio/Vertex AI 모두 접근 가능하며, 차이는 프로젝트/권한/쿼터/과금 체계입니다.

복사 + 다운로드

키 복사 : 발급 직후 화면에서 키를 복사해 비공개 보관소(시크릿 매니저/환경 변수 파일)에 저장하세요.
환경 변수 : Linux/macOS → export GEMINI_API_KEY="YOUR_KEY"
Windows PowerShell → $env:GEMINI_API_KEY="YOUR_KEY"
주의 : 공개 저장소(GitHub 등)나 프런트엔드 코드에 직접 노출 금지

원본/출처 제공

문서 : AI Studio 도움말, Cloud Console(Quotas/Usage), 모델별 가격표·쿼터 안내를 기준으로 확인
로그 : 호출 오류(401/403/429/400 등)는 콘솔 대시보드에서 원인 점검 후 조치
모델 : 사용 모델명(Gemini 2.5 등)과 입력/출력 토큰 정책 확인

기타

API 호출은 보통 프로젝트 단위로 쿼터가 관리됩니다.
같은 프로젝트에서 API 키를 여러 개 만들어도 일일 한도는 공유됩니다.
프로젝트를 분리하면 쿼터가 분산되어 운영 유연성이 커집니다.
보안 : 유출 시 즉시 폐기/재발급, 필요 시 도메인/리퍼러/IP 제한 적용
오류 : 401/403(권한·결제·설정), 429(레이트 리밋), 400(요청 형식/모델)을 우선 점검

발급/운영 전략(프로젝트 분산)

핵심 : 레이트 리밋은 프로젝트 단위로 적용 → 프로젝트를 나누면 독립 쿼터로 분산 가능

권장 : “프로젝트별 1개 키” 원칙으로 분리 운영

예시(설명용 수치)
O 프로젝트 10개 · 각 API 키 1개 = (프로젝트별 일일 한도) × 10 → 총 사용량 확장
X 프로젝트 1개 · API 키 10개 = 동일 프로젝트의 쿼터 공유 → 일일 한도 변화 없음
※ 예: GEMINI 2.5 기준 일일 250회라면, 10개 프로젝트면 250×10=2,500회, 1개 프로젝트에서 키 10개는 여전히 250회로 동일(예시 수치).