googleapis/python-genai

Google Gen AI SDK (python‑genai)

무엇인가요 – Google의 Gemini 생성형 AI 모델(공개 Gemini Developer API 및 Gemini Enterprise Agent Platform)을 호출할 수 있는 공식 Python 클라이언트 라이브러리입니다. 인증, 요청 구성, 스트리밍, 비동기 사용, 응답 파싱을 처리하여 프롬프트와 결과에만 집중할 수 있도록 도와줍니다.

주요 기능

• API 키 또는 엔터프라이즈 자격 증명을 사용해 genai.Client 생성.
• client.models.generate_content(...) 를 호출하여 gemini-flash-latest 또는 gemini-3.1-pro-preview 와 같은 Gemini 모델에서 텍스트, 이미지, 동영상을 얻음.
• 동기 및 비동기 사용 모두 지원 (Client().aio).
• 유연한 입력: 일반 문자열, types.Part 객체, 파일 업로드, 함수 호출 파트.
• Pydantic 모델 또는 일반 사전을 통해 구성 가능 (예: GenerateContentConfig, SafetySetting).
• 자동 함수 호출 (AFC) – Python callable을 도구로 전달하고 모델이 호출하도록 하며, 비활성화 옵션 제공.
• 스트리밍, 실시간, 프록시 지원; 선택적으로 aiohttp 를 통한 빠른 비동기 클라이언트 제공.
• HTTP 연결이 올바르게 닫히도록 보장하는 컨텍스트 매니저 헬퍼 제공.

일반적인 워크플로우

from google import genai
from google.genai import types

client = genai.Client(api_key='YOUR_KEY')
response = client.models.generate_content(
    model='gemini-flash-latest',
    contents='하늘은 왜 파란가요?',
    config=types.GenerateContentConfig(max_output_tokens=50)
)
print(response.text)
client.close()

대상 사용자 – 저수준 HTTP 세부 사항을 다루지 않고도 애플리케이션, 스크립트, 서비스에 Gemini의 대규모 언어 모델 기능(텍스트 생성, 이미지 생성, 함수 호출, 안전성 제어 등)을 통합하고자 하는 Python 개발자.

자세한 정보 – 전체 문서는 https://googleapis.github.io/python-genai/, PyPI 페이지, 그리고 README에 링크된 Gemini API 참조 문서를 참고하세요.