Gemini API 라이브러리

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

새 라이브러리에 관한 중요사항

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

주요 라이브러리 업데이트

언어 이전 라이브러리 새 라이브러리 (권장)
Python google-generativeai google-genai
JavaScript
및 TypeScript
@google/generative-ai @google/genai
현재 미리보기 버전임
이동 google.golang.org/generative-ai google.golang.org/genai

이전 라이브러리를 사용하는 모든 사용자는 새 라이브러리로 이전하는 것이 좋습니다. JavaScript/TypeScript 라이브러리가 미리보기 버전임에도 불구하고 JavaScript/TypeScript 섹션에 나열된 주의사항에 익숙하다면 이전을 시작하는 것이 좋습니다.

Python

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

pip install google-genai

JavaScript 및 TypeScript

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

npm install @google/genai

새로운 JavaScript/TypeScript 라이브러리는 현재 미리보기 상태이므로 기능이 완전하지 않을 수 있으며 브레이킹 체인지를 도입해야 할 수도 있습니다.

하지만 이러한 주의사항에 익숙하다면 곧 지원 중단될 이전 버전보다 새 SDK를 사용하는 것이 좋습니다. Google에서는 이 라이브러리의 GA (일반 안정화) 출시를 위해 적극적으로 노력하고 있습니다.

클라이언트 측 애플리케이션의 API 키

경고: 사용 중인 라이브러리에 관계없이 API 키를 클라이언트 측 JavaScript 또는 TypeScript 코드에 삽입하는 것은 안전하지 않습니다. 프로덕션에서 Gemini API에 액세스하기 위해 서버 측 배포를 사용합니다.

Go

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

go get google.golang.org/genai

이전 라이브러리 및 SDK

다음은 더 이상 개발되지 않는 이전 SDK의 집합입니다. 이전 가이드를 사용하여 업데이트된 Google Gen AI SDK로 전환할 수 있습니다.