Gemini API 라이브러리

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

새 라이브러리 관련 중요사항

2024년 말부터 Gemini API와 Vertex AI를 모두 통해 Google의 생성형 AI 모델에 액세스하기 위한 통합 인터페이스를 제공하는 새로운 라이브러리 세트인 Google 생성형 AI SDK를 점진적으로 출시하여 이러한 플랫폼 간의 전환을 간소화하고 있습니다.

이제 Google 생성형 AI SDK가 Gemini 모델에 액세스하는 데 권장되는 경로이며 문서의 모든 코드 스니펫은 이러한 라이브러리를 활용합니다. Gemini Developer API와 Vertex AI 간에 이전하는 방법에 관한 자세한 내용은 Vertex AI 페이지를 참고하세요.

주요 라이브러리 업데이트

언어 이전 라이브러리 새 라이브러리 (권장)
Python google-generativeai google-genai
JavaScript
및 TypeScript
@google/generative-ai @google/genai
Go google.golang.org/generative-ai google.golang.org/genai

모든 사용자는 Google GenAI SDK로 이전하는 것이 좋습니다. 잘 유지관리되는 개발자 경로를 제공할 뿐만 아니라 기존 라이브러리에서 사용할 수 없는 새로운 기능 (예: 이미지 및 동영상 생성)과 실시간 API 기능에 액세스할 수 있기 때문입니다. 시간이 지남에 따라 기능 격차가 커질 것으로 예상됩니다.

라이브러리 설치

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

pip install google-genai

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

npm install @google/genai

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

go get google.golang.org/genai

이전 라이브러리 및 SDK

새 라이브러리를 사용할 수 있는 플랫폼의 경우 새 라이브러리로 이전하는 것이 좋습니다. 이전 라이브러리에는 새로운 기능이 제공되지 않으며, 구체적인 지원 상태는 아래에 자세히 설명되어 있습니다.

아직 새 공식 라이브러리를 사용할 수 없는 플랫폼의 경우 Google API를 직접 호출하거나, 커뮤니티에서 유지관리하는 라이브러리를 사용하거나, 신뢰할 수 있는 서드 파티 옵션을 활용할 수 있습니다. Google은 공식 SDK 지원 범위를 확대하기 위해 노력하고 있으며, 새 라이브러리가 출시되면 여기에 표시됩니다.

이전 라이브러리는 다음과 같습니다.