Migracja do pakietu Google GenAI SDK

Pod koniec 2024 r. wraz z wydaniem Gemini 2.0 wprowadziliśmy nowy zestaw bibliotek o nazwie Google GenAI SDK. Dzięki zaktualizowanej architekturze klienta zapewnia on lepsze wrażenia deweloperom i upraszcza przejście między przepływami pracy deweloperów a przepływami pracy w przedsiębiorstwie.

Google GenAI SDK jest teraz w ogólnej dostępności (GA) na wszystkich obsługiwanych platformach. Jeśli używasz jednej z naszych starszych bibliotek, zdecydowanie zalecamy migrację.

W tym przewodniku znajdziesz przykłady kodu przed i po migracji, które pomogą Ci zacząć.

Instalacja

Przed

Python

pip install -U -q "google-generativeai"

JavaScript

npm install @google/generative-ai

Go

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

Po

Python

pip install -U -q "google-genai"

JavaScript

npm install @google/genai

Go

go get google.golang.org/genai

Dostęp API

Stary pakiet SDK niejawnie obsługiwał klienta API w tle za pomocą różnych metod ad hoc. Utrudniało to zarządzanie klientem i danymi logowania. Teraz możesz wchodzić w interakcje za pomocą centralnego obiektu Client. Ten obiekt Client działa jako pojedynczy punkt wejścia dla różnych usług API (np. models, chats, files, tunings), co zwiększa spójność i upraszcza zarządzanie danymi logowania i konfiguracją w różnych wywołaniach API.

Przed (mniej scentralizowany dostęp do interfejsu API)

Python

Stary pakiet SDK nie używał jawnie obiektu klienta najwyższego poziomu w przypadku większości wywołań API. Bezpośrednio tworzyłeś instancje obiektów GenerativeModel i wchodziłeś z nimi w interakcje.

import google.generativeai as genai

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