IT · AI · 2026
제미나이 API 키 발급 완벽 정리 — 5분 만에 끝내는 실전 가이드
Google AI Studio에서 무료로 발급받고 바로 써먹는 Gemini API 설정법
왜 지금 제미나이 API인가
솔직히 말하면, 처음에 저도 그냥 ChatGPT API만 쓰면 되지 않나 싶었어요. 그런데 여러 AI 자동화 프로젝트를 운영하다 보니, 무료로 시작할 수 있는 Gemini API의 존재감이 점점 커지더라고요. 특히 블로그 자동화나 유튜브 스크립트 초안 작업에 보조 엔진으로 활용하니 비용 부담이 확 줄었습니다.
Google이 Gemini를 전면에 내세우면서 API 무료 티어도 상당히 넉넉하게 풀었어요. 개인 프로젝트 수준이라면 유료 전환 없이도 꽤 오래 버틸 수 있는 구조거든요. 시작 장벽이 낮다는 건 그만큼 실험하기 좋다는 뜻이기도 해요.
발급 전 준비사항
딱 하나만 있으면 됩니다. Google 계정이에요. 별도의 신용카드나 결제 수단은 무료 티어 기간엔 전혀 필요 없고요, Google AI Studio에 로그인하는 것만으로 발급 준비가 끝나요. 처음이라면 서비스 약관 동의 화면이 뜨는데, 그냥 한 번 읽고 동의하면 기본 프로젝트가 자동으로 생성됩니다.
단계별 발급 방법
말로 설명하면 복잡해 보이지만, 실제로 해보면 정말 5분이면 끝나요. 아래 순서대로만 따라가면 됩니다.
무료 티어 모델별 사용 한도
무료로 쓸 수 있다고 해서 무제한은 아니에요. 모델마다 일일 요청 한도(RPD)가 다르니, 어떤 모델을 주로 쓸지 먼저 파악해두는 게 중요해요. 아래 표를 참고하세요.
Gemini API 무료 티어 모델 비교
| 모델 | 일일 요청 한도(RPD) | 분당 요청(RPM) | 추천 용도 |
|---|---|---|---|
| gemini-2.5-pro | 25회 | 5회 | 복잡한 추론, 긴 문서 분석 |
| gemini-2.5-flash | 200회 | 10회 | 일반 텍스트 생성, 요약 |
| gemini-2.5-flash-lite | 1,000회 | 30회 | 고빈도 자동화, 배치 작업 |
| gemini-1.5-flash | 200회 | 15회 | 멀티모달, 이미지 분석 |
환경 설정 및 코드 적용
키를 소스 코드에 직접 박아 넣는 건 절대 금물이에요. Git에 올라가는 순간 전 세계에 공개되는 거나 마찬가지거든요. 반드시 환경 변수로 관리해야 합니다.
OS별 환경 변수 설정 방법
| 운영체제 | 설정 파일 | 명령어 예시 |
|---|---|---|
| Linux / Bash | ~/.bashrc | export GEMINI_API_KEY=발급받은키 |
| macOS / Zsh | ~/.zshrc | export GEMINI_API_KEY=발급받은키 |
| Windows | 시스템 환경 변수 | 환경 변수 검색 > 새로 만들기 |
Python에서 쓸 때는 genai.Client(api_key="YOUR_API_KEY") 형태로 직접 넘기거나, 환경 변수를 자동으로 읽도록 설정하면 됩니다. REST 방식이라면 요청 헤더에 x-goog-api-key 값으로 키를 전달하면 돼요.
보안 관리에서 놓치면 안 되는 것들
꼭 해야 할 것
IP 제한 또는 HTTP 리퍼러 제한 설정, 필요한 API만 활성화, 프로젝트별 키 분리 운영, 180일 이상 미사용 시 키 재생성
절대 하면 안 되는 것
소스 코드(Git)에 키 직접 커밋, 클라이언트 사이드 JS에 키 노출, 여러 서비스에 동일 키 공유 사용
직접 써보니 이런 게 좋았다
블로그 자동화 파이프라인에 Gemini API를 붙여봤는데, 속도가 꽤 빠르더라고요. 특히 Flash 계열 모델은 응답 레이턴시가 낮아서 대량 처리할 때 체감이 확실히 달랐어요. Claude나 GPT-4를 메인으로 쓰고, Gemini를 보조로 조합하는 방식이 현재 저한테는 가장 효율적인 구성이에요.
무료로 이 정도 성능이 나온다는 게 솔직히 좀 놀라웠습니다. 개인 프로젝트나 토이 앱 수준에선 유료 전환 없이도 충분히 돌아가고요. 다만 Pro 모델은 일일 25회라는 제한이 생각보다 빡빡해서, 중요한 작업엔 Flash를 먼저 써보고 필요할 때만 Pro를 끌어다 쓰는 전략이 낫더라고요.
유튜브 유사성 감지 기능 완벽 정리 — AI 딥페이크로부터 내 얼굴을 지키는 법