Gemini API 라이브러리

Gemini API 라이브러리

Gemini API로 빌드할 때는 Google GenAI SDK를 사용하는 걸 권장해요. 이 라이브러리는 인기가 높은 언어용으로 Google이 개발·유지보수하는 공식 프로덕션 레디 라이브러리예요. General Availability 단계이며 모든 공식 문서와 예제에서 사용돼요.

참고: 레거시 라이브러리를 쓰고 있다면 Google GenAI SDK로 마이그레이션하는 걸 강력히 권장해요. 자세한 내용은 레거시 라이브러리 섹션을 참고하세요. AI 코딩 어시스턴트를 쓴다면 Gemini API 개발 스킬을 설치해 최신 문서와 모범 사례에 접근하세요.

Gemini API가 처음이라면 Get started 가이드부터 시작해 보세요.

출처: 원문

본문

언어 지원과 설치

Google GenAI SDK는 Python, JavaScript/TypeScript, Go, Java 언어를 지원해요. 각 언어의 라이브러리는 패키지 매니저로 설치하거나 GitHub 저장소에서 더 깊게 확인할 수 있어요.

Python

JavaScript

Go

Java

  • 라이브러리: google-genai
  • GitHub 저장소: googleapis/java-genai
  • 설치: Maven을 쓴다면 dependencies에 다음을 추가하세요.
<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

General availability

2025년 5월부터 Google GenAI SDK는 모든 지원 플랫폼에서 GA(General Availability)를 달성했고, Gemini API에 접근하는 권장 라이브러리가 됐어요. 안정적이고 프로덕션 사용을 완전히 지원하며 지속적으로 유지보수돼요. 최신 기능에 접근할 수 있고 Gemini와 함께 쓸 때 최고의 성능을 제공해요.

레거시 라이브러리를 사용 중이라면 최신 기능에 접근하고 최상의 성능을 얻으려면 마이그레이션을 강력히 권장해요. 레거시 라이브러리 섹션을 참고하세요.

레거시 라이브러리와 마이그레이션

레거시 라이브러리를 사용 중이라면 새 라이브러리로 마이그레이션하길 권장해요.

레거시 라이브러리는 최근 기능(Live API, Veo 등)에 접근할 수 없고, 2025년 11월 30일부터 폐기(deprecated)됐어요.

각 레거시 라이브러리의 지원 상태는 다음 표와 같아요.

언어 레거시 라이브러리 지원 상태 권장 라이브러리
Python google-generativeai Not actively maintained google-genai
JavaScript/TypeScript @google/generativeai Not actively maintained @google/genai
Go google.golang.org/generative-ai Not actively maintained google.golang.org/genai
Dart and Flutter google_generative_ai Not actively maintained Genkit Dart 또는 Firebase AI Logic 사용
Swift generative-ai-swift Not actively maintained Firebase AI Logic 사용
Android generative-ai-android Not actively maintained Firebase AI Logic 사용

Java 개발자 참고: Gemini API용 기존 Google 제공 Java SDK가 없었으므로 이전 Google 라이브러리에서 마이그레이션할 필요가 없어요. 언어 지원과 설치 섹션의 새 라이브러리로 바로 시작하면 돼요.

더 알아보기 (Learn more)