Khi tạo bằng Gemini API, bạn nên sử dụng Google GenAI SDK. Đây là những thư viện chính thức, sẵn sàng cho quá trình sản xuất 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 thuật ngữ này thuộc Phạm vi cung cấp chung và được dùng trong tất cả tài liệu và ví dụ chính thức của chúng tôi.
Nếu bạn mới làm quen với Gemini API, hãy làm theo hướng dẫn bắt đầu nhanh của chúng tôi để bắt đầu.
Hỗ trợ ngôn ngữ và cài đặt
Google GenAI SDK có sẵn cho 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 ngôn ngữ đó để tương tác thêm:
Python
Thư viện:
google-genai
Kho lưu trữ GitHub: googleapis/python-genai
Cài đặt:
pip install google-genai
JavaScript
Thư viện:
@google/genai
Kho lưu trữ GitHub: googleapis/js-genai
Cài đặt:
npm install @google/genai
Go
Thư viện:
google.golang.org/genai
Kho lưu trữ GitHub: googleapis/go-genai
Cài đặt:
go get google.golang.org/genai
Java
Thư viện:
google-genai
Kho lưu trữ GitHub: googleapis/java-genai
Cài đặt: Nếu bạn đang sử dụng Maven, hãy thêm nội dung 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>
Giai đoạn phát hành rộng rãi
Chúng tôi bắt đầu triển khai Google GenAI SDK (một bộ thư viện mới để truy cập vào Gemini API) vào cuối năm 2024 khi ra mắt Gemini 2.0.
Kể từ tháng 5 năm 2025, các thư viện này đã được phát hành công khai (GA) trên tất cả các nền tảng được hỗ trợ và là các thư viện được đề xuất để truy cập vào Gemini API. Các API này ổn định, được hỗ trợ đầy đủ cho mục đích sử dụng trong quá trình sản xuất và được duy trì liên tục. Các mô hình 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 các thư viện cũ để biết thêm thông tin.
Thư viện cũ và quá trình di chuyển
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 sang các 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à đang trong quá trình ngừng hoạt động. Các ứng dụng này sẽ ngừng nhận bản cập nhật vào cuối tháng 9 năm 2025, các khoảng trống về tính năng sẽ tăng lên và các lỗi tiềm ẩn có thể không còn được khắc phục nữa.
Trạng thái hỗ trợ của mỗi thư viện cũ sẽ khác nhau, được nêu 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 |
Mọi hoạt động hỗ trợ, bao gồm cả việc sửa lỗi, sẽ kết thúc vào cuối tháng 9 năm 2025. | google-genai |
JavaScript/TypeScript | @google/generativeai |
Mọi hoạt động hỗ trợ, bao gồm cả việc sửa lỗi, sẽ kết thúc vào cuối tháng 9 năm 2025. | @google/genai |
Go | google.golang.org/generative-ai |
Mọi hoạt động hỗ trợ, bao gồm cả việc sửa lỗi, sẽ kết thúc vào cuối tháng 9 năm 2025. | google.golang.org/genai |
Dart và Flutter | google_generative_ai |
Không được duy trì thường xuyên | Sử dụng các thư viện đáng tin cậy của cộng đồng hoặc bên thứ ba, chẳng hạn như firebase_ai, hoặc truy cập bằng API REST |
Swift | generative-ai-swift |
Không được duy trì thường xuyên | Sử dụng Gemini trong Firebase |
Android | generative-ai-android |
Không được duy trì thường xuyên | Sử dụng Gemini trong Firebase |
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, nên bạn không cần di chuyển từ một thư viện trước đây của Google. Bạn có thể bắt đầu ngay với thư viện mới trong phần Hỗ trợ ngôn ngữ và cài đặt.