Gemini API란?
Gemini API는 개발자가 Google의 생성형 AI 모델을 자신이 만든 프로그램·웹사이트·업무 도구에 연결할 수 있는 개발자용 인터페이스입니다. 일반 이용자가 대화하는 Gemini 앱과 API의 기능·요금·사용량 한도는 서로 다를 수 있습니다. 본문은 2026년 9월을 기준으로 API의 작동 원리와 선택 방법을 설명하며, 특정 모델을 항상 최신 모델로 단정하지 않습니다.
시작하기 전에 Google 공식 시작 안내, 현재 모델 목록, 요금표를 확인하세요.
1. 앱과 API, 무엇이 다른가?
| 구분 | Gemini 앱 | Gemini API |
|---|---|---|
| 사용자 | 대화와 개인 업무를 수행하는 일반 사용자 | AI 기능을 소프트웨어에 연결하는 개발자 |
| 설정 | 서비스 화면에서 직접 사용 | API 키·프로젝트·코드 또는 자동화 도구 구성 |
| 비용 | 앱 요금제 기준 | 선택한 모델·기능·실제 사용량 기준 |
| 예시 | 질문·요약·아이디어 정리 | 고객 문의 분류·자료 요약·내부 문서 검색 |
2. Flash와 Pro 같은 모델 계열 이해
Gemini에는 목적과 지원 기능이 다른 여러 모델이 있습니다. 속도를 중시하는 단순 분류용 모델과 복잡한 추론에 사용하는 모델을 별도로 시험할 수 있습니다. 단, 실제 기능과 비용은 같은 계열에서도 버전별로 다르므로 모델명만 보고 무조건 빠르거나 정확하다고 결론 내리지 마세요. 프로젝트에서 제공되는 정확한 모델 ID는 공식 모델 목록이나 Google AI Studio에서 확인합니다.
3. 처음 연결하는 흐름
- Google AI Studio에서 API 키를 발급합니다.
- 키를 서버 환경변수 또는 비밀 관리 도구에 저장합니다. 브라우저·공개 GitHub에는 넣지 않습니다.
- 공식 google-genai SDK로 간단한 Python 예제를 실행합니다.
- 출력 결과와 요청·응답 토큰 사용량을 확인하고, 모델과 입력 형식을 기록합니다.
- 운영에 쓰기 전 프로젝트별 요청 한도와 데이터 처리 조건을 확인합니다.
4. 고유 실습: 카페 고객 문의 분류
실제 개인정보가 없는 가상의 문의 ‘아이스라테 한 잔 주문했는데 디카페인으로 변경할 수 있나요?’를 입력하고, 분류 결과를 메뉴 변경, 환불, 기타 중 하나로 반환하도록 요청해 보세요. 결과가 맞더라도 실제 주문 변경은 직원 승인을 받은 뒤 처리합니다.
입력: 아이스라테 한 잔 주문했는데 디카페인으로 변경할 수 있나요?
출력 형식: {"category":"메뉴 변경","needs_staff":true,"reason":"주문 옵션 변경 문의"}가상 문의 10건에 같은 지시문을 적용하고 정답표를 직접 만든 뒤, 분류 오류·누락·확실하지 않은 응답을 기록하면 자신이 사용하려는 모델의 실제 적합성을 살펴볼 수 있습니다. 이는 예시이지 Gemini API의 실측 성능을 나타내는 수치가 아닙니다.
5. 자주 묻는 질문
API 키 발급만 하면 무료인가요?
키 발급 여부와 실제 API 과금은 별개입니다. 무료 티어에서도 모델별 이용 가능 범위와 제한이 있으므로 공식 요금표와 대시보드를 확인하세요.
모든 모델이 이미지·오디오·비디오를 지원하나요?
지원 입력·출력 형식은 모델별로 다릅니다. 멀티모달 작업 전에 원하는 기능이 해당 모델에 제공되는지 공식 문서를 확인해야 합니다.
문제 발생 시 어디부터 확인하나요?
API 키와 프로젝트, 정확한 모델 ID, 요청·토큰 한도, 오류 응답 순서로 점검하세요. 코드 예제와 운영 오류 해결은 별도 학습 글에서 다룹니다.