Khi xây dựng bằng Gemini API, bạn nên sử dụng Google GenAI SDK. Đây là các thư viện chính thức, sẵn sàng cho hoạt động phát hành chính thức mà chúng tôi phát triển và duy trì cho các ngôn ngữ phổ biến nhất. Các API này đang trong giai đoạn phát hành rộng rãi và được dùng trong tất cả tài liệu cũng như ví dụ chính thức của chúng tôi.
Nếu bạn mới sử dụng Gemini API, hãy làm theo Hướng dẫn bắt đầu sử dụng của chúng tôi để bắt đầu.
Hỗ trợ ngôn ngữ và cài đặt
SDK AI tạo sinh của Google hỗ trợ các ngôn ngữ Python, JavaScript/TypeScript, Go và Java. Bạn có thể cài đặt thư viện của từng ngôn ngữ bằng trình quản lý gói hoặc truy cập vào kho lưu trữ GitHub của các thư viện đó để tìm hiểu thêm:
Python
Thư viện:
google-genaiKho lưu trữ GitHub: googleapis/python-genai
Cài đặt:
pip install google-genai
JavaScript
Thư viện:
@google/genaiKho lưu trữ GitHub: googleapis/js-genai
Cài đặt:
npm install @google/genai
Go
Thư viện:
google.golang.org/genaiKho lưu trữ GitHub: googleapis/go-genai
Cài đặt:
go get google.golang.org/genai
Java
Thư viện:
google-genaiKho lưu trữ GitHub: googleapis/java-genai
Cài đặt: Nếu bạn đang sử dụng Maven, hãy thêm phần sau vào các phần phụ thuộc:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
C#
Thư viện:
Google.GenAIKho lưu trữ GitHub: googleapis/dotnet-genai
Cài đặt:
dotnet add package Google.GenAI
Giai đoạn phát hành rộng rãi
Kể từ tháng 5 năm 2025, SDK Google GenAI đã đạt giai đoạn phát hành rộng rãi (GA) trên tất cả các nền tảng được hỗ trợ và là thư viện nên dùng để truy cập vào Gemini API. Các phiên bản này ổn định, được hỗ trợ đầy đủ cho mục đích phát hành chính thức và được duy trì liên tục. Các trình duyệt này cung cấp quyền truy cập vào các tính năng mới nhất và mang lại hiệu suất tốt nhất khi hoạt động với Gemini.
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 để có thể sử dụng các tính năng mới nhất và đạt được hiệu suất tốt nhất khi làm việc với Gemini. Hãy xem phần thư viện cũ để biết thêm thông tin.
Thư viện cũ và di chuyển
Nếu đang sử dụng một trong các thư viện cũ, bạn nên di chuyển sang thư viện mới.
Các thư viện cũ không cung cấp quyền truy cập vào các tính năng gần đây (chẳng hạn như Live API và Veo) và sẽ ngừng hoạt động kể từ ngày 30 tháng 11 năm 2025.
Trạng thái hỗ trợ của mỗi thư viện cũ sẽ khác nhau, được trình bày chi tiết trong bảng sau:
| Ngôn ngữ | Thư viện cũ | Trạng thái hỗ trợ | Thư viện đề xuất |
|---|---|---|---|
| Python | google-generativeai |
Không được duy trì thường xuyên | google-genai |
| JavaScript/TypeScript | @google/generativeai |
Không được duy trì thường xuyên | @google/genai |
| Bắt đầu | google.golang.org/generative-ai |
Không được duy trì thường xuyên | google.golang.org/genai |
| Dart và Flutter | google_generative_ai |
Không được duy trì thường xuyên | Sử dụng Genkit Dart hoặc Firebase AI Logic |
| Swift | generative-ai-swift |
Không được duy trì thường xuyên | Sử dụng Firebase AI Logic |
| Android | generative-ai-android |
Không được duy trì thường xuyên | Sử dụng Firebase AI Logic |
Lưu ý dành cho nhà phát triển Java: Không có SDK Java cũ do Google cung cấp cho Gemini API, vì vậy, bạn không cần di chuyển từ thư viện trước đó của Google. Bạn có thể bắt đầu trực tiếp với thư viện mới trong phần Hỗ trợ ngôn ngữ và cài đặt.