이럴 때 비교적 가볍게 시작하기 좋은 선택지가 Google의 Gemini API입니다. Gemini API는 Google AI Studio에서 API를 발급받아 사용할 수 있고, 일부 모델은 무료 티어로 테스트해볼 수 있습니다. 다만 무료라고 해서 무제한은 아니며, 모델별 요청 제한과 토큰 제한이 있기 때문에 사용 전략을 잘 잡는 것이 중요합니다.
Gemini API키 발급 방법
Gemini API를 사용하려면 먼저 Google AI Studio에서 API Key를 발급받아야 합니다.
1. Google AI Studio에 접속합니다.
2. Google 계정으로 로그인 합니다.
3. 좌측 하단 열쇠를 눌러 API Key 메뉴로 이동합니다.
4. 사용할 Google Cloud 프로젝트를 선택하거나 새 프로젝트를 생성합니다.
5. 생성된 API Key를 복사합니다.
6. Python, C#, JavaScript 등 프로그램 코드에서 해당 키를 환경 변수로 등록해 사용합니다.
API Key는 외부에 노출되면 안 됩니다. 특히 GitHub, 블로그, 클라이언트 프로그램 내부 코드에 그대로 넣으면 다른 사람이 내 키로 API를 호출할 수 있습니다. 가능하면 서버에만 호출하거나, 환경 변수로 관리하는 방식이 안전합니다.
Python 예시 코드
아래는 Python에서 Genmini 2.5 Flash 모델을 호출하는 간단한 예시입니다.
from google import genai
import os
client = genai.Client(api_key=os.getenv("GEMINI_API_KEY"))
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="오늘의 이슈를 500자 이내로 자연스럽게 작성해줘."
)
print(response.text)
서설치 명령어는 다음과 같습니다.
환경 변수는 Windows 기준으로 다음과 같이 등록할 수 있습니다.
무료 버전과 유료 버전 차이
Gemini API는 무료 티어에서도 일부 모델을 사용할 수 있지만, 무료 티어는 테스트와 개인 개발용에 가깝습니다. 실제 서비스에 적용하거나 사용자가 많은 프로그램에 붙일 경우에는 유료 전환을 고려해야 합니다.
| 구분 | 무료 티어 | 유료 티어 |
|---|---|---|
| 비용 | 일부 모델 무료 사용 가능 | 사용량 기준 과금 |
| 데이터 사용 | Google 제품 개선에 사용될 수 있음 | 제품 개선에 사용되지 않음 |
| 요청 제한 | 낮음 | 더 높은 제한 |
| 안정성 | 테스트용에 적합 | 서비스 운영에 적합 |
| 추천 용도 | 개인 테스트, 기능 검증, 소규모 자동화 | 실제 서비스, 상용 프로그램, 대량 처리 |
무료 티어는 "일단 붙여보고 테스트하는 용도"로 생각하는 것이 좋습니다. 반대로 블로그 자동 작성 프로그램, 상품 소개글 생성기, 사용자 입력 기반 AI 기능처럼 실제 사용량이 발생하는 기능은 유료 티어 기준으로 비용 계산을 해두는 것이 안전합니다.
토큰, 일일 요청, 분당 요청 이해하기
Genmini API의 제한은 보통 세 가지 기준으로 나뉩니다.
| 항목 | 의미 |
|---|---|
| RPM | Requests Per Minute, 분당 요청 수 |
| TPM | Tokens Per Minute, 분당 입력 토큰 수 |
| RPD | Requests Per Day, 하루 요청 수 |
예를 들어 RPM이 20이라면 1분 안에 21번 호출했을 때 오류가 발생할 수 있습니다. 또 요청 횟수는 적어도 한 번에 너무 긴 글을 보내면 TPM제한에 걸릴 수 있습니다.
중요한 점은 제한이 API Key 단위가 아니라 프로젝트 단위로 적용된다는 점입니다. API Key를 여러 개 만들어도 무료 사용량이 무한으로 늘어나는 구조가 아닙니다.
무료 티어 사용 전략
무료 티어를 효율적으로 사용하려면 질문을 짧고 명확하게 보내는 것이 좋습니다. 예를 들어 "이 상품을 글로 써줘"라고 보내는 것보다, 필요한 조건을 정리해서 보내는 방식이 더 안정적입니다.
좋은 요청 예시는 다음과 같습니다.아래 상품 정보를 바탕으로 500자 이내의 블로그 소개글을 작성해줘.
조건 :
- 제목 포함
- 장점 3가지
- 추천 대상 포함
- 과장 광고 표현 금지
상품명 : Gemini API 활용방법 도서
가격 : 36,300원
불필요하게 긴 설명, 중복된 HTML, 너무 많은 상품 정보를 한 번에 보내면 토큰 사용량이 증가합니다. 무료 티어에서는 한 번에 많은 요청을 보내기보다 요청 간격을 두는 것이 좋습니다.
프로그램에 적용할 때는 다음 전략을 추천합니다.1. 요청 간격을 3~5초 이상 두기
2. 실패 시 즉시 재시도하지 않고 10초 이상 대기하기
3. 긴 글 작성은 한 번에 처리하되, 너무 긴 원문은 요약 후 전송하기
4. 태그 생성, 제목 생성, 요약처럼 짧은 작업은 Flash-Lite 사용하기
5. 본문 작성은 Gemini 2.5 Flash 사용하기
6. 정말 복잡한 분석만 Pro 사용하기
자주 발생하는 오류
Gemini API를 사용할 때 자주 만나는 오류는 대부분 API Key, 요청 제한, 모델명, 결제설정과 관련이 있습니다.
| 오류 유형 | 원인 | 해결방법 |
|---|---|---|
| 400 Bad Request | 요청 형식 오류, 잘못된 파라미터 | JSON 구조와 모델명 확인 |
| 401 Unauthorized | API Key 오류 | API Key 재확인, 환경 변수 확인 |
| 403 Forbidden | 권한 또는 결제 설정 문제 | 프로젝트 권한, API활성화, 결제 설정 확인 |
| 404 Not Found | 모델명 오류 | 사용 가능한 모델명 확인 |
| 429 Too Many Requests | 분당/일일 요청 제한 초과 | 요청 간격 늘리기, 재시도 대기 적용 |
| 500/503 Error | 서버 일시 오류 | 잠시 후 재시도 |
특히 429 Too Many Requests 오류는 무료 티어에서 자주 볼 수 있습니다. 이 경우 코드를 잘못 작성했다기보다는 너무 짧은 시간에 많은 요청을 보냈을 가능성이 큽니다.
Flash 모델을 기본값으로 추천하는 이유
Gemini 2.5 Flash는 가격, 속도, 품질의 균형이 좋습니다. 블로그 글 작성, 상품 설명, 문장 다듬기, 요약, 제목 추천, HTML 생성 같ㅇ은 일반적인 작업은 대부분 Flash로 충분합니다.
마무리
Gemini API는 AI기능을 프로그램에 붙이고 싶은 개발자에게 좋은 선택지입니다. 무료 티어로 간단한 테스트를 해볼 수 있고, Flash모델을 활용하면 비용 부담을 줄이면서도 블로그 글 작성, 상품 소개글 생성, 요약, 태그 생성 기능을 충분히 구현 할 수 있습니다. 다만 무료 티어는 무제한이 아니며, 요청 수와 토큰 제한이 있습니다. 실제 서비스나 배포용 프로그램에서는 반드시 사용량 제한, 오류 처리, 재시도 대기, 모델 선택 옵션을 함께 넣는 것이 좋습니다.
개인적으로는 기본 모델을 Gemini 2.5 Flash로 두고, 짧은 작업은 Flash-Lite, 고급 분석은 Pro로 분리하는 방식을 추천합니다. 이렇게 구성하면 무료 티어에서도 테스트하기 쉽고, 유료 전환 후에도 비용을 효율적으로 관리할 수 있습니다.
첫 댓글을 남겨보세요.