Google 생성형 AI 라이브러리

이 페이지에서는 Gemini API용 최신 라이브러리를 다운로드하고 설치하는 방법을 설명합니다. Gemini API를 처음 사용하는 경우 API 빠른 시작을 참고하세요.

google-genai 라이브러리에 관한 중요사항

Google은 최근 다양한 Google 서비스에서 Google의 생성형 AI 모델에 액세스할 수 있는 더욱 일관되고 간소화된 환경을 제공하는 새로운 라이브러리 세트를 출시했습니다.

Vertex AI 라이브러리는 Vertex AI 플랫폼에서만 지원됩니다.

주요 라이브러리 업데이트

언어 Vertex AI 라이브러리 새 라이브러리(권장)
Python google-cloud-aiplatform
2026년 5월 GenerativeModel 모듈 지원 중단 		google-genai
Go cloud.google.com/vertexai
2026년 5월 지원 중단됨 		google.golang.org/genai
JavaScript 및 TypeScript @google-cloud/vertexai
2026년 5월 지원 중단됨 		@google/genai
프리뷰 버전으로 사용 가능
Java google-cloud-vertexai
2026년 5월 지원 중단됨 		java-genai
프리뷰 버전으로 사용 가능

사용자는 새 라이브러리로 시작하고 이전 라이브러리에서 이전하는 것이 좋습니다.

라이브러리 설치

다음 예시는 다양한 프로그래밍 언어에서 시작하는 데 도움이 될 수 있습니다.

Python

다음을 실행하여 Python 라이브러리를 설치할 수 있습니다.

  pip install google-genai

Go

다음을 실행하여 Go 라이브러리를 설치할 수 있습니다.

  go get google.golang.org/genai

JavaScript 및 TypeScript

다음을 실행하여 JavaScript 및 TypeScript 라이브러리를 설치할 수 있습니다.

  npm install @google/genai

새 JavaScript 및 TypeScript 라이브러리는 프리뷰로 제공되므로 기능이 완전하지 않을 수 있으며 중대한 변경사항이 도입될 수 있습니다.

하지만 이러한 주의 사항에 동의하는 경우 이전의 지원 중단된 버전 대신 새 SDK를 사용하는 것이 좋습니다. Google에서는 이 라이브러리의 GA(일반 출시) 버전을 출시하기 위해 열심히 노력하고 있습니다.

Java

Maven에 종속 항목을 추가하여 Java 라이브러리를 설치할 수 있습니다.

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

새 Java 라이브러리는 프리뷰로 제공되므로 기능이 완전하지 않을 수 있으며 중대한 변경사항을 도입해야 할 수도 있습니다.

하지만 이러한 주의사항에 익숙하다면 이전의 지원 중단된 버전 대신 새 SDK를 사용하는 것이 좋습니다. Google에서는 이 라이브러리의 GA(일반 출시) 버전을 출시하기 위해 열심히 노력하고 있습니다.