Gemini API 라이브러리

Gemini API로 빌드할 때는 Google 생성형 AI SDK를 사용하는 것이 좋습니다. 이는 가장 널리 사용되는 언어를 위해 Google에서 개발하고 유지관리하는 공식 프로덕션 지원 라이브러리입니다. 일반 안정화 버전이며 모든 공식 문서와 예시에 사용됩니다.

Gemini API를 처음 사용하는 경우 빠른 시작 가이드에 따라 시작하세요.

언어 지원 및 설치

Google GenAI SDK는 Python, JavaScript/TypeScript, Go, Java 언어로 제공됩니다. 패키지 관리자를 사용하여 각 언어의 라이브러리를 설치하거나 GitHub 저장소를 방문하여 자세히 알아볼 수 있습니다.

Python

자바스크립트

Go

자바

  • 라이브러리: google-genai

  • GitHub 저장소: googleapis/java-genai

  • 설치: Maven을 사용하는 경우 종속 항목에 다음을 추가합니다.

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

정식 버전

Google은 2024년 말 Gemini 2.0을 출시하면서 Gemini API에 액세스할 수 있는 새로운 라이브러리 세트인 Google 생성형 AI SDK를 출시하기 시작했습니다.

2025년 5월부터 지원되는 모든 플랫폼에서 정식 버전 (GA)으로 출시되었으며 Gemini API에 액세스하는 데 권장되는 라이브러리입니다. 안정적이고 프로덕션 용도로 완전히 지원되며 적극적으로 유지 관리됩니다. 최신 기능에 액세스할 수 있으며 Gemini와 함께 작동할 때 최고의 성능을 제공합니다.

기존 라이브러리 중 하나를 사용하는 경우 Gemini를 사용하여 최신 기능에 액세스하고 최상의 성능을 얻을 수 있도록 마이그레이션하는 것이 좋습니다. 자세한 내용은 이전 라이브러리 섹션을 참고하세요.

기존 라이브러리 및 이전

기존 라이브러리 중 하나를 사용하는 경우 새 라이브러리로 마이그레이션하는 것이 좋습니다.

기존 라이브러리는 최신 기능 (예: Live API 및 Veo)에 대한 액세스를 제공하지 않으며 지원 중단 경로에 있습니다. 2025년 11월 30일부터 업데이트가 중단되고 기능 격차가 커지며 잠재적인 버그가 더 이상 수정되지 않을 수 있습니다.

각 기존 라이브러리의 지원 상태는 다음 표에 자세히 설명되어 있습니다.

언어 기존 라이브러리 지원 상태 권장 라이브러리
Python google-generativeai 버그 수정 등 모든 지원은 2025년 11월 30일에 종료됩니다. google-genai
JavaScript/TypeScript @google/generativeai 버그 수정 등 모든 지원은 2025년 11월 30일에 종료됩니다. @google/genai
Go google.golang.org/generative-ai 버그 수정 등 모든 지원은 2025년 11월 30일에 종료됩니다. google.golang.org/genai
Dart 및 Flutter google_generative_ai 활발하게 유지되지 않음 신뢰할 수 있는 커뮤니티 또는 서드 파티 라이브러리(예: firebase_ai)를 사용하거나 REST API를 사용하여 액세스
Swift generative-ai-swift 활발하게 유지되지 않음 Firebase AI Logic 사용
Android generative-ai-android 활발하게 유지되지 않음 Firebase AI Logic 사용

Java 개발자 참고: Gemini API용 기존 Google 제공 Java SDK가 없으므로 이전 Google 라이브러리에서 이전할 필요가 없습니다. 언어 지원 및 설치 섹션에서 새 라이브러리를 바로 시작할 수 있습니다.

코드 생성 프롬프트 템플릿

생성 모델 (예: Gemini, Claude) 및 AI 기반 IDE (예: 커서)는 학습 데이터 컷오프로 인해 오래되었거나 지원 중단된 라이브러리를 사용하여 Gemini API용 코드를 생성할 수 있습니다. 생성된 코드에서 권장되는 최신 라이브러리를 사용하려면 프롬프트에 직접 버전과 사용 안내를 제공하세요. 아래 템플릿을 사용하여 필요한 컨텍스트를 제공할 수 있습니다.