googleapis/python-genai

Google Gen AI Python SDK

개요 – Google의 Gemini 생성 AI 모델(공개 Gemini Developer API 및 Gemini Enterprise Agent Platform 모두)을 호출할 수 있는 퍼스트 파티 Python 클라이언트 라이브러리입니다. REST 엔드포인트를 편리하고 타입이 지정된 인터페이스로 래핑하며 인증, HTTP 전송 및 응답 파싱을 처리합니다.

주요 기능

• API 키(공개 Gemini) 또는 엔터프라이즈 자격 증명(프로젝트, 위치)을 사용하여 genai.Client를 생성합니다.
• client.models.generate_content를 호출하여 gemini-3.5-flash 또는 gemini-2.5-flash와 같은 Gemini 모델로부터 텍스트, 이미지 또는 비디오를 가져옵니다.
• 일반 문자열, 딕셔너리 또는 더 풍부한 google.genai.types Pydantic 모델(예: Part.from_text, Part.from_uri, Part.from_function_call)을 입력으로 제공합니다.
• GenerateContentConfig를 사용하여 생성 구성(temperature, top-p/k, max tokens, safety settings, system instructions, response modalities 등)을 설정합니다.
• 자동 함수 호출 사용: Python 호출 가능 객체를 도구로 전달하면 모델이 이를 호출할 수 있으며, 명시적인 함수 호출 객체를 받으려면 이를 비활성화할 수 있습니다.
• 스트리밍, 비동기 호출(client.aio를 통해) 및 빠른 aiohttp 전송 옵션을 지원합니다.
• 프록시, 사용자 지정 기본 URL 및 API 버전 선택(v1, v1alpha)에 대한 내장 처리.
• 자동 리소스 정리를 위한 컨텍스트 매니저 지원 및 명시적인 close()/aclose() 메서드.
• 모델 목록 표시, 파일 업로드 및 안전 설정 설정을 위한 헬퍼 유틸리티.

전형적인 사용법

from google import genai
from google.genai import types

client = genai.Client(api_key="YOUR_GEMINI_API_KEY")
response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents=types.Part.from_text("Why is the sky blue?"),
    config=types.GenerateContentConfig(temperature=0, top_p=0.95),
)
print(response.text)

중요성 – Google Gemini API의 저수준 HTTP 세부 사항을 추상화하고, 타입 안전한 요청 구축을 제공하며, 함수 호출 및 안전 제어와 같은 고급 기능을 통합하여 Python 개발자가 최첨단 생성 AI를 애플리케이션, 서비스 또는 연구 노트북에 쉽게 내장할 수 있도록 합니다.

문서 및 설치

• Docs: https://googleapis.github.io/python-genai/
• Install: pip install google-genai (또는 uv pip install google-genai)