최근 생성형 AI를 단순히 채팅으로 사용하는 것을 넘어 직접 프로그램에 연결해 활용하려는 분들이 많아졌습니다.
특히 구글의 Gemini는 웹에서 사용하는 것뿐만 아니라 Gemini API를 이용해 Python 같은 프로그래밍 언어에서 직접 호출할 수 있다는 점이 장점인데요.
간단한 테스트나 개인 프로젝트라면 무료 티어로도 Gemini API를 시작해볼 수 있습니다.
이번 글에서는 Gemini API가 무엇인지, 무료로 사용할 수 있는 방법과 함께 Python에서 직접 질문을 보내는 방법까지 간단하게 정리해보겠습니다.
Gemini API란?
Gemini API는 구글의 생성형 AI 모델인 Gemini를 프로그램에서 직접 사용할 수 있도록 제공되는 API입니다.
예를 들어 Python 프로그램에서 다음과 같은 작업을 할 수 있습니다.
- 질문에 대한 답변 생성
- 긴 글 요약
- 텍스트 분류
- 번역
- 콘텐츠 작성
- 코드 생성 및 분석
- 이미지·영상 등 멀티모달 데이터 분석
즉, 사람이 직접 Gemini 웹사이트에 질문하는 대신 내가 만든 프로그램이 Gemini에게 질문하고 답변을 받아오는 방식이라고 생각하면 이해하기 쉽습니다.
구글은 Google AI Studio를 통해 Gemini API를 테스트하고 API 키를 발급받을 수 있도록 제공하고 있습니다.
Gemini API는 무료로 사용할 수 있을까?
결론부터 말하면 무료 티어가 있습니다.
현재 Gemini Developer API에는 무료 티어가 제공되고 있으며, 일부 모델에 대해 무료 입력·출력 토큰을 사용할 수 있습니다. 다만 모든 모델과 기능을 무제한으로 사용할 수 있는 것은 아니며 모델별 사용량 제한이 적용됩니다.
API의 사용량 제한은 대표적으로 다음과 같은 방식으로 관리됩니다.
| 구분 | 의미 |
|---|---|
| RPM | 분당 요청 횟수 |
| TPM | 분당 처리 토큰 수 |
| RPD | 하루 요청 횟수 |
따라서 개인적으로 API를 공부하거나 간단한 프로그램을 만들어 테스트하는 용도라면 무료 티어가 상당히 유용하지만, 대규모 서비스에서 사용하는 경우에는 별도의 사용량과 비용을 확인해야 합니다.
또한 무료 티어와 유료 티어는 사용할 수 있는 모델과 기능, 요청 한도 등에 차이가 있습니다.
Gemini API 키는 어디서 발급할까?
API를 사용하려면 먼저 Gemini API 키가 필요합니다.
Gemini Developer API 가격 책정 | Gemini API | Google AI for Developers
위의 Google AI Studio에서 API 키를 생성할 수 있으며, 발급받은 API 키를 프로그램에서 사용하면 됩니다. 링크페이지에서 무료로 시작하기를 클릭해 줍니다.
이후에는 API키를 생성해야 하는데요. API 키는 일종의 비밀번호와 비슷하게 생각하는 것이 좋습니다. 로그인 후 약관에 동의하고 상단에 위치한 API 키 만들기를 누릅니다.
프로젝트를 새로 만들어도 되고 기본으로 하셔도 무방합니다. 나중에 프로젝트간 다른걸 하시려면 프로젝트 이름과 키 이름을 설정해주세요.
지금은 테스트라 단순히 키 만들기 누르셔도 됩니다.
생성이 되면 API키가 만들어지는데요.
특히 GitHub 같은 공개 저장소에 API 키를 그대로 올리면 다른 사람이 해당 키를 사용할 수 있기 때문에 주의해야 합니다.
구글 역시 API 키를 비밀번호처럼 취급하고, 노출된 경우 새 키를 생성하고 기존 키를 비활성화하는 등의 보안 조치를 권장하고 있습니다.
Python에서 Gemini API 사용하기
Python에서는 현재 구글이 제공하는 google-genai SDK를 사용할 수 있습니다.
먼저 파이썬 패키지를 설치합니다.
pip install -U google-genai그 다음 간단한 Python 코드를 작성할 수 있습니다.
from google import genai
API_KEY = "여기에_GEMINI_API_KEY"
client = genai.Client(api_key=API_KEY)
response = client.models.generate_content(
model="gemini-3.7-flash",
contents="현재 미국 대통령의 이름은 누구인가?"
)
print(response.text)실행하면 Gemini가 질문에 대한 답변을 반환합니다.
이처럼 몇 줄의 Python 코드만으로도 내가 만든 프로그램에서 Gemini를 호출할 수 있습니다. 즉 gemini 홈페이지가 아니어도 gemini를 사용할 수 잇는 것인데요.
구글의 현재 Python 시작 가이드 역시 google-genai 패키지를 설치한 뒤 from google import genai 방식으로 클라이언트를 생성하는 방법을 안내하고 있습니다.
API 키는 코드에 직접 넣지 않는 것이 좋다
테스트할 때는 코드에 API 키를 직접 입력할 수도 있지만 실제 프로그램에서는 권장하지 않습니다.
예를 들어 .env 파일에 API 키를 저장하고 Python에서 불러오는 방법을 사용할 수 있습니다.
GEMINI_API_KEY=여기에_API_KEYPython에서는 다음과 같이 사용할 수 있습니다.
import os
from dotenv import load_dotenv
from google import genai
load_dotenv()
client = genai.Client(
api_key=os.getenv("GEMINI_API_KEY")
)
response = client.models.generate_content(
model="gemini-3.7-flash",
contents="안녕하세요. 자기소개를 해주세요."
)
print(response.text)이렇게 구성하면 API 키가 Python 코드에 직접 노출되는 것을 피할 수 있습니다.
그리고 .env 파일은 GitHub 등에 올라가지 않도록 .gitignore에 추가하는 것이 좋습니다.
무료 Gemini API, 어디에 활용할 수 있을까?
Gemini API를 직접 연결하면 활용 범위가 상당히 넓어집니다.
예를 들어 뉴스 자동화 프로그램을 만든다면 뉴스 기사를 수집한 뒤 Gemini API에 전달해 요약하거나 제목을 생성하도록 만들 수 있습니다.
개발 공부를 하는 입장에서도 API를 직접 사용해보면 생성형 AI가 단순한 채팅 서비스가 아니라 프로그램의 기능 중 하나로 들어갈 수 있다는 점을 이해하는 데 도움이 됩니다.
무료라고 해서 무제한은 아니다
여기서 한 가지 주의할 점이 있습니다.
Gemini API의 무료 티어는 무제한 무료 API라는 의미가 아닙니다.
모델에 따라 무료 사용량과 요청 제한이 존재하며, 일정량을 초과하면 제한에 걸릴 수 있습니다. 또한 유료 티어에서는 더 높은 사용량 한도와 추가 기능을 이용할 수 있습니다. 아래 링크에서 한도를 찾아볼 수 있습니다.
https://aistudio.google.com/rate-limit
따라서 처음에는 무료 티어로 API 구조와 사용 방법을 익혀보고, 실제 서비스로 확장할 때는 필요한 모델과 예상 사용량을 기준으로 비용을 확인하는 것이 좋습니다.
마무리
Gemini API는 개발자가 자신의 프로그램에 Gemini의 생성형 AI 기능을 직접 연결할 수 있는 방법입니다.
특히 무료 티어가 제공되기 때문에 처음 API를 공부하거나 개인 프로젝트를 테스트해보려는 개발자라면 부담 없이 시작해볼 수 있습니다.
Google AI Studio에서 API 키를 발급받고 google-genai 패키지를 설치하면 Python에서도 몇 줄의 코드로 Gemini를 호출할 수 있습니다.
간단한 질문부터 시작해서 텍스트 요약, 콘텐츠 생성, 데이터 분석, 자동화 프로그램 등으로 활용 범위를 넓혀보는 것도 좋은 방법입니다.
다만 무료 티어에는 모델별 사용량 제한이 있으므로 실제 서비스에 적용하기 전에는 최신 요금과 제한 정책을 확인하는 것이 좋습니다.
그럼 잘 사용하시기 바랍니다.