Gemini API 키 발급: Google AI Studio 설정과 무료 한도 확인

Gemini API 키 발급 전 확인할 것

Gemini API는 Google AI Studio에서 프로젝트와 API 키를 관리합니다. 화면 배치와 모델 제공 목록, 무료·유료 사용 한도는 수시로 변경될 수 있으므로 2026년 9월 기준 아래 공식 안내를 따라 확인하는 편이 안전합니다. Google API 키 공식 안내 · Google AI Studio 키 관리 화면 · 공식 요금표.

1. API 키 만드는 순서

1. 개인 Google 계정으로 Google AI Studio에 접속합니다.
2. API 키 관리 화면에서 새 키 생성을 선택합니다. 필요한 경우 키를 연결할 프로젝트를 선택하거나 생성합니다.
3. 생성한 키를 안전하게 복사합니다. 키가 화면에 다시 표시되지 않는 경우 재발급이 필요할 수 있습니다.
4. 프로젝트 대시보드에서 사용 가능한 모델과 현재 사용량·결제 단계를 확인합니다.

주의: 키 생성 자체와 모델 호출 비용은 다른 문제입니다. 무료 사용 범위가 존재하더라도 모든 모델이 무료이거나 무제한으로 제공되는 것은 아닙니다. 프로젝트·모델·지역·사용 단계에 따라 조건이 달라집니다.

2. 키 보관과 Python 테스트

API 키를 HTML·브라우저 JavaScript·공개 GitHub 저장소에 직접 넣지 마세요. 개발 PC에서는 GEMINI_API_KEY 환경변수나 접근 제한된 비밀 관리 도구를 사용합니다.

python -m pip install -U google-genai
# Windows PowerShell 환경변수(현재 세션만):
$env:GEMINI_API_KEY = "본인_키"

macOS/Linux에서는 터미널에서 export GEMINI_API_KEY="본인_키" 형식으로 설정합니다. 실제 사용 예시는 Gemini API Python 실습에서 확인하세요. 현재 Google의 Python SDK는 google-genai이며 옛 예제의 google.generativeai 패키지와 구분해야 합니다.

3. 무료 사용량과 429 오류

Gemini API 제한은 분당 요청(RPM), 분당 토큰(TPM), 일별 요청(RPD) 등을 기준으로 적용될 수 있습니다. 한도는 API 키별이 아니라 프로젝트·모델 및 사용 단계에 따라 달라집니다. Google AI Studio의 실제 프로젝트 대시보드를 기준으로 확인하세요. 제한을 초과하면 429 RESOURCE_EXHAUSTED가 발생할 수 있습니다.

참고: 공식 한도 설명, 429 오류 해결 가이드. 키가 노출되었다면 키를 폐기·재발급하고 과금과 사용 로그를 즉시 확인하세요.

4. 고유 실습: 테스트 키 점검표

실제 고객 데이터가 아닌 테스트 문장으로 1회 호출한 뒤 아래 항목을 기록해 보세요.

예시 표는 점검용 템플릿이며 특정 계정의 실제 사용량을 나타내지 않습니다.