제미나이 무료 API 사용법 및 파이썬 연동

개발자들을 위한 제미나이 무료 API 사용법을 파이썬(Python) 예제와 함께 상세히 설명합니다. 코드를 통해 효율적으로 AI 기능을 개발하는 방법을 알아보세요.
1. 개발 환경 준비 및 라이브러리 설치
제미나이 API를 파이썬에서 사용하기 위해서는 먼저 구글 제미나이 SDK를 설치해야 합니다. 터미널이나 명령 프롬프트에서 다음 명령어를 실행합니다.
pip install google-generativeai
이 라이브러리는 구글의 공식 SDK로, 제미나이 모델과의 통신을 담당합니다. 파이썬 3.7 이상의 버전이 필요하며, 가상 환경(Virtual Environment)을 사용하여 프로젝트를 관리하는 것이 권장됩니다.
2. API 키 설정 및 모델 초기화
설치가 완료되면, 파이썬 스크립트에서 API 키를 설정하고 모델을 초기화합니다. 앞서 발급받은 API 키를 환경 변수로 설정하거나 코드에 직접 입력할 수 있습니다.
import google.generativeai as genai
# API 키 설정 (실제 사용 시 환경 변수 사용 권장)
API_KEY = "YOUR_API_KEY"
genai.configure(api_key=API_KEY)
# 모델 초기화 (Gemini Pro 선택)
model = genai.GenerativeModel('gemini-pro')
# 채팅 세션 시작
chat = model.start_chat(history=[])
이 코드는 'gemini-pro' 모델을 로드하고, 대화 세션을 초기화합니다. 'history=[]'는 이전 대화 기록을 초기화하여 새로운 대화를 시작한다는 의미입니다.
3. 간단한 텍스트 생성 예제
기본적인 텍스트 생성 기능을 구현하는 코드입니다. 사용자의 질문에 대한 답변을 받아오는 간단한 구조입니다.
# 질문 전송 및 응답 받기
response = chat.send_message("인공지능의 미래에 대해 간단히 설명해줘.")
print(response.text)
이 코드를 실행하면 제미나이가 인공지능의 미래에 대한 요약된 답변을 텍스트로 반환합니다. 'response.text' 속성을 통해 생성된 텍스트만 추출할 수 있습니다.
4. 멀티모달(이미지) 처리 예제
제미나이는 텍스트뿐만 아니라 이미지도 이해할 수 있는 멀티모달 모델입니다. 'gemini-pro-vision' 모델을 사용하여 이미지를 분석하는 예제입니다.
import PIL.Image
# 이미지 로드
img = PIL.Image.open('sample.jpg')
# 모델 선택 (Vision 모델)
model = genai.GenerativeModel('gemini-pro-vision')
# 이미지와 텍스트 프롬프트 전송
response = model.generate_content(img)
print(response.text)
이 코드는 로컬 파일 시스템의 이미지를 읽어와, 이미지 내용을 분석하고 설명하는 텍스트를 생성합니다. 무료 API에서도 이러한 멀티모달 기능을 제한적으로 사용할 수 있습니다.
5. 스트리밍 응답 구현
긴 답변을 실시간으로 받아오는 스트리밍 기능을 구현하면 사용자 경험을 향상시킬 수 있습니다. 제미나이 API는 스트리밍을 지원하며, 제너레이터(Generator)를 사용하여 구현합니다.
response = chat.send_message("긴 이야기를 들려줘.", stream=True)
for chunk in response:
print(chunk.text, end="", flush=True)
이 코드는 답변이 생성되는 대로 부분적으로 화면에 출력하여, 로딩 시간을 줄이고 실시간성을 제공합니다. 데이터 처리 및 네트워크 지연 시간을 최소화하는 데 유용합니다.
6. API 사용 시 주의사항 및 오류 처리
무료 API 사용 시 발생할 수 있는 주요 오류는 다음과 같습니다.
- 429 Too Many Requests: 일일 요청 한도를 초과했습니다. 잠시 후 다시 시도하거나, 요청 빈도를 줄이세요.
- 400 Bad Request: 프롬프트 형식이 잘못되었습니다. 텍스트와 이미지의 조합이 올바른지 확인하세요.
- 500 Internal Server Error: 구글 서버 측 문제입니다. 대부분 잠시 후 자동으로 해결됩니다.
코드 작성 시 try-except 블록을 사용하여 네트워크 오류를 대비하는 것이 좋습니다.