Kể từ bản phát hành Gemini 2.0 vào cuối năm 2024, chúng tôi đã giới thiệu một bộ thư viện mới có tên là Google GenAI SDK. Nền tảng này mang đến trải nghiệm cải thiện cho nhà phát triển thông qua cấu trúc ứng dụng mới và đơn giản hoá quá trình chuyển đổi giữa quy trình làm việc của nhà phát triển và doanh nghiệp.
Google GenAI SDK hiện đã được phát hành rộng rãi (GA) trên tất cả các nền tảng được hỗ trợ. Nếu đang sử dụng một trong các thư viện cũ của chúng tôi, bạn nên di chuyển.
Hướng dẫn này cung cấp các ví dụ về mã trước và sau khi di chuyển để giúp bạn bắt đầu.
Cài đặt
Trước
Python
pip install -U -q "google-generativeai"
JavaScript
npm install @google/generative-ai
Go
go get github.com/google/generative-ai-go
Sau
Python
pip install -U -q "google-genai"
JavaScript
npm install @google/genai
Go
go get google.golang.org/genai
Quyền truy cập API
SDK cũ đã xử lý ngầm ứng dụng API ở chế độ nền bằng nhiều phương thức đặc biệt. Điều này gây khó khăn cho việc quản lý ứng dụng và thông tin đăng nhập.
Giờ đây, bạn tương tác thông qua một đối tượng Client trung tâm. Đối tượng Client này hoạt động như một điểm truy cập duy nhất cho nhiều dịch vụ API (ví dụ: models, chats, files, tunings), giúp tăng tính nhất quán và đơn giản hoá việc quản lý thông tin đăng nhập và cấu hình trên nhiều lệnh gọi API.
Trước đây (Quyền truy cập API ít tập trung hơn)
Python
SDK cũ không sử dụng rõ ràng đối tượng ứng dụng cấp cao nhất cho hầu hết các lệnh gọi API. Bạn sẽ trực tiếp tạo bản sao và tương tác với các đối tượng GenerativeModel.
import google.generativeai as genai
# Directly create and use model objects
model = genai.GenerativeModel('gemini-3.6-flash')
response = model.generate_content(...)
chat = model.start_chat(...)
JavaScript
Mặc dù GoogleGenerativeAI là điểm trung tâm cho các mô hình và cuộc trò chuyện, nhưng các chức năng khác như quản lý tệp và bộ nhớ đệm thường yêu cầu nhập và khởi tạo các lớp ứng dụng hoàn toàn riêng biệt.
import { GoogleGenerativeAI } from "@google/generative-ai";
import { GoogleAIFileManager, GoogleAICacheManager } from "@google/generative-ai/server"; // For files/caching
const genAI = new GoogleGenerativeAI("GEMINI_API_KEY");
const fileManager = new GoogleAIFileManager("GEMINI_API_KEY");
const cacheManager = new GoogleAICacheManager("GEMINI_API_KEY");
// Get a model instance, then call methods on it
const model = genAI.getGenerativeModel({ model: "gemini-3.6-flash" });
const result = await model.generateContent(...);
const chat = model.startChat(...);
// Call methods on separate client objects for other services
const uploadedFile = await fileManager.uploadFile