Google GenAI SDK로 이전

2024년 말 Gemini 2.0 출시와 함께 Google GenAI SDK라는 새로운 라이브러리 세트가 도입되었습니다. 업데이트된 클라이언트 아키텍처를 통해 개선된 개발자 환경을 제공하고 개발자와 엔터프라이즈 워크플로 간의 전환을 간소화합니다.

Google GenAI SDK는 이제 정식 버전 (GA)으로 지원되는 모든 플랫폼에서 제공됩니다. 기존 레거시 라이브러리 중 하나를 사용하는 경우 이전하는 것이 좋습니다.

이 가이드에서는 시작하는 데 도움이 되도록 이전된 코드의 이전 및 이후 예를 제공합니다.

설치

전

Python

pip install -U -q "google-generativeai"

JavaScript

npm install @google/generative-ai

Go

go get github.com/google/generative-ai-go

후

Python

pip install -U -q "google-genai"

JavaScript

npm install @google/genai

Go

go get google.golang.org/genai

API 액세스

이전 SDK는 다양한 임시 메서드를 사용하여 백그라운드에서 API 클라이언트를 암시적으로 처리했습니다. 이로 인해 클라이언트와 사용자 인증 정보를 관리하기가 어려웠습니다. 이제 중앙 Client 객체를 통해 상호작용합니다. 이 Client 객체는 다양한 API 서비스 (예: models, chats, files, tunings)의 단일 진입점 역할을 하여 일관성을 높이고 다양한 API 호출에서 사용자 인증 정보 및 구성 관리를 간소화합니다.

전 (덜 중앙 집중식 API 액세스)

Python

이전 SDK는 대부분의 API 호출에 최상위 클라이언트 객체를 명시적으로 사용하지 않았습니다. GenerativeModel 객체를 직접 인스턴스화하고 상호작용합니다.

import google.generativeai as genai

# Directly create and use model objects
model = genai.GenerativeModel('gemini-3.5-flash')
response = model.generate_content(...)
chat = model.start_chat(...)

JavaScript

GoogleGenerativeAI는 모델 및 채팅의 중앙 지점이었지만 파일 및 캐시 관리와 같은 다른 기능은 완전히 별도의 클라이언트 클래스를 가져오고 인스턴스화해야 하는 경우가 많았습니다.

import { GoogleGenerativeAI } from "@google/generative-ai";
import { GoogleAIFileManager, GoogleAICacheManager } from "@google/generative-ai/server"; // For files/caching

const genAI =