Gemini API 라이브러리

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

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

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

주요 라이브러리 업데이트

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

이전 라이브러리의 모든 사용자는 새 라이브러리로 마이그레이션하는 것이 좋습니다. JavaScript/TypeScript 라이브러리가 미리보기 버전이지만 JavaScript/TypeScript 섹션에 나열된 주의사항에 동의하는 한 마이그레이션을 시작하는 것이 좋습니다.

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

pip install google-genai

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

npm install @google/genai

새 JavaScript/TypeScript 라이브러리는 현재 미리보기 버전이므로 기능이 완전하지 않을 수 있으며 중대한 변경사항을 도입해야 할 수도 있습니다.

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

경고: 어떤 라이브러리를 사용하든 클라이언트 측 JavaScript 또는 TypeScript 코드에 API 키를 삽입하는 것은 안전하지 않습니다. 프로덕션에서 Gemini API에 액세스하려면 서버 측 배포를 사용하세요.

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

go get google.golang.org/genai

다음은 더 이상 적극적으로 개발되지 않는 이전 SDK 모음입니다. 이전 가이드를 사용하여 업데이트된 Google 생성형 AI SDK로 전환할 수 있습니다.