Gemini API 라이브러리

Gemini API로 빌드할 때는 Google 생성형 AI SDK를 사용하는 것이 좋습니다. 프로덕션에 즉시 사용 가능한 공식 라이브러리인 Google 생성형 AI SDK는 가장 널리 사용되는 프로그래밍 언어용으로 개발 및 유지보수됩니다. 일반 제공 상태이며 모든 공식 문서와 예시에 사용됩니다.

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>

C#

정식 버전

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

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

기존 라이브러리 및 이전

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

기존 라이브러리는 최신 기능 (예: Live API 및 Veo)에 대한 액세스를 제공하지 않으며 2025년 11월 30일부로 지원 중단됩니다.

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

언어 기존 라이브러리 지원 상태 권장 라이브러리
Python google-generativeai 활발하게 유지되지 않음 google-genai
JavaScript/TypeScript @google/generativeai 활발하게 유지되지 않음 @google/genai
Go google.golang.org/generative-ai 활발하게 유지되지 않음 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 라이브러리에서 이전할 필요가 없습니다. 언어 지원 및 설치 섹션에서 새 라이브러리를 바로 시작할 수 있습니다.