인공지능 기술을 자신의 서비스에 접목하고 싶지만, 복잡한 AI 모델을 직접 개발하는 것은 큰 부담이 될 수 있습니다. 오늘은 구글의 가장 강력한 AI 모델인 ‘제미나이(Gemini)’ 의 능력을 누구나 쉽게 활용할 수 있도록 돕는 프로그래밍 도구, 제미나이 API에 대해 소개해 드리고자 합니다.
제미나이 API란?#
구글 제미나이(Gemini) API는 개발자들이 구글의 최첨단 인공지능 모델을 자신의 애플리케이션이나 서비스에 쉽게 연동할 수 있도록 만든 프로그래밍 인터페이스(API) 입니다.
간단히 말해, 복잡한 AI 모델을 직접 만들거나 운영할 필요 없이, 이 API를 ‘호출’하는 것만으로 제미나이의 뛰어난 능력을 빌려 쓸 수 있게 해주는 ‘연결 다리’ 역할을 합니다.
주요 특징#
멀티모달(Multimodal) 지원: 제미나이의 가장 큰 특징으로, 텍스트뿐만 아니라 이미지, 오디오, 비디오까지 한 번에 이해하고 처리할 수 있습니다. 예를 들어, 이미지와 텍스트를 함께 API에 보내 “이 사진에 어울리는 광고 문구를 만들어 줘"와 같은 복합적인 요청이 가능합니다.
다양한 모델 제공: 가볍고 빠른 ‘제미나이 1.5 플래시(Gemini 1.5 Flash)’ 부터 균형 잡힌 성능의 ‘제미나이 1.5 프로(Gemini 1.5 Pro)’ 까지 다양한 모델을 제공하여, 사용 목적과 비용에 맞게 최적의 모델을 선택할 수 있습니다.
쉬운 접근성: 개발자들은 Google AI Studio를 통해 간단한 API 키 발급만으로 빠르게 기능을 테스트해 볼 수 있으며, 더 큰 규모의 서비스는 Google Cloud의 Vertex AI 플랫폼을 통해 안정적으로 운영할 수 있습니다.
무엇을 만들 수 있나요?#
지능형 챗봇 및 고객센터: 사람처럼 자연스럽게 대화하며 사용자의 질문에 답변하는 챗봇
콘텐츠 자동 생성: 블로그 글, 마케팅 이메일, 소스 코드, 소설 등 다양한 종류의 텍스트 생성
요약 및 분석: 긴 문서나 회의록을 핵심만 요약하거나, 이미지 속 객체를 분석하고 설명하는 기능 구현
창의적인 도구: 사용자가 업로드한 이미지나 영상을 기반으로 새로운 스토리를 만들거나, 교육 자료를 생성하는 창의적인 앱 개발
요금 정책: 무료와 유료 플랜#
제미나이 API는 개인적인 학습과 테스트를 위한 넉넉한 무료 사용량과, 실제 서비스에 적용하기 위한 합리적인 종량제 요금을 제공합니다.
무료 사용량 (Free Tier)#
Google AI Studio를 통해 발급받은 API 키는 별도의 비용 없이 사용할 수 있는 무료 등급이 적용됩니다. 아래는 주요 Gemini API 모델별 무료 티어(Free Tier) 사용량 한도의 정리입니다.(2025년 7월 기준)
| 모델 | 분당 요청(RPM) | 분당 토큰(TPM) | 일일 요청(RPD) | 비고 |
|---|---|---|---|---|
| Gemini 2.5 Pro | 5 | 250,000 | 100 | Google AI Studio 무료, 컨텍스트 윈도 1M |
| Gemini 2.5 Flash | 10 | 250,000 | 250 | 빠른 답변용, Flash-Lite 대비 낮은 한도 |
| Gemini 2.5 Flash-Lite | 15 | 250,000 | 1,000 | 초경량 LLM, 높은 일일 사용량 |
| Gemini 2.0 Flash | 15 | 1,000,000 | 200 | |
| Gemini 2.0 Flash-Lite | 30 | 1,000,000 | 200 |
- 분당 요청수(RPM): 1분에 처리할 수 있는 최대 API 요청 건수
- 분당 토큰수(TPM): 1분에 입력할 수 있는 최대 토큰(단어 등) 수
- 일일 요청수(RPD): 1일 동안 API로 보낼 수 있는 총 요청 건수
- Google AI Studio는 무료로 사용 가능, 별도 API 호출 비용 없음
- RPM (Requests Per Minute): 1분 동안 보낼 수 있는 최대 요청 횟수입니다.
이 무료 등급은 개인 프로젝트, 학습, 기능 테스트 용도로는 충분하지만, 사용자가 많은 서비스에 적용하기에는 제한적일 수 있습니다.
유료 요금 (Pay-as-you-go)#
무료 사용량 한도를 초과하거나 더 높은 처리량이 필요한 경우, Google Cloud 프로젝트에 결제를 설정하여 사용한 만큼 비용을 지불하는 종량제(Pay-as-you-go)로 전환할 수 있습니다. 요금은 주로 백만 토큰(1M tokens) 단위로 책정됩니다.
Gemini API 주요 가격표 (2025년 7월 기준)
| 모델 | 입력 (1M 토큰당, USD) | 출력 (1M 토큰당, USD) | 컨텍스트 캐싱 (1M 토큰/시간) | 비고 |
|---|---|---|---|---|
| Gemini 2.5 Pro | $1.25 (≤200K) / $2.50 (>200K) | $10.00 (≤200K) / $15.00 (>200K) | $0.31 (≤200K) / $0.625 (>200K) / $4.50(스토리지) | 장문 프롬프트 가격 상승 |
| Gemini 2.5 Flash | $0.15 | $0.60 (일반) / $3.50(Thinking 포함) | $0.0375 | |
| Gemini 2.0 Flash | $0.10 | $0.40 | $0.025 | |
| Gemini 2.0 Flash-Lite | $0.075 | $0.30 | - | |
| 이미지 출력 | - | $30/1M 토큰 (약 $0.039/장) | - | 최대 1024x1024px |
| Grounding(Google Search) | 무료(1,500 RPD) | 이후 $35/1K 요청 | - |
- 토큰(Token): 모델이 텍스트를 처리하는 기본 단위로, 대략 영어 단어 하나가 1~2 토큰에 해당합니다. (한글은 더 많은 토큰을 사용합니다.)
더 자세한 최신 정보는 **Gemini API 공식 가격 정책 페이지 **를 참고하시는 것이 가장 정확합니다.
제미나이 API 시작하기#
아래의 간단한 3단계만으로 제미나이 API를 직접 사용해 볼 수 있습니다.
1단계: API 키 발급받기#
Google AI Studio 웹사이트에 접속하여 구글 계정으로 로그인합니다.
왼쪽 메뉴에서 **[Get API key]**를 클릭합니다.
[Create API key] 버튼을 눌러 새로운 API 키를 생성합니다.
생성된 API 키 문자열을 복사하여 안전한 곳에 보관합니다. 이 키는 코드에서 제미나이를 호출할 때 사용됩니다.
2단계: Python 라이브러리 설치#
터미널을 열고 아래 명령어를 실행하여 Python용 Google AI 라이브러리를 설치합니다.
pip install -q -U google-generativeai
3단계: Python 코드로 API 호출하기#
이제 Python 스크립트 파일을 만들어 아래 코드를 작성합니다.
import os
import google.generativeai as genai
# 1. API 키 설정
# ※ 주의: 실제 코드에 API 키를 직접 넣는 것은 보안상 위험합니다.
# 아래 코드는 예시이며, 실제로는 환경 변수 등을 사용하는 것이 안전합니다.
genai.configure(api_key="YOUR_API_KEY") # 👈 여기에 1단계에서 복사한 API 키를 붙여넣으세요.
# 2. 모델 초기화
# 'gemini-1.5-flash'는 가볍고 빠른 모델입니다.
model = genai.GenerativeModel('gemini-1.5-flash')
# 3. 프롬프트(질문)를 보내고 응답 받기
prompt = "Go 언어의 장점 3가지만 알려줘"
response = model.generate_content(prompt)
# 4. 결과 출력
print(response.text)
이 스크립트를 실행하면, 제미나이 API가 prompt의 내용을 이해하고 생성한 답변이 터미널에 출력됩니다.
이것이 제미나이 API를 사용하는 가장 기본적인 흐름입니다.
마무리하며#
제미나이 API는 개발자들이 복잡한 인프라 구축 없이도 최첨단 AI 기술을 손쉽게 활용할 수 있도록 지원하는 강력한 도구입니다. 이 가이드를 시작으로 여러분의 창의적인 아이디어를 제미나이와 함께 현실로 만들어 보시길 바랍니다.
참조
Google AI Studio: https://aistudio.google.com/
Gemini API 공식 가격 정책: https://ai.google.dev/pricing
Gemini API Python SDK 문서: https://ai.google.dev/docs/gemini_api_overview?hl=ko&lang=python