Thư viện Gemini API

Khi xây dựng bằng Gemini API, bạn nên sử dụng SDK Google GenAI. Đây là các 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 thư viện này đang ở giai đoạn phát hành rộng rãi và được sử 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 sử dụng Gemini API, hãy làm theo hướng dẫn bắt đầu nhanh để bắt đầu.

Hỗ trợ ngôn ngữ và cài đặt

SDK Google GenAI 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

JavaScript

Go

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>

C#

  • Thư viện: Google.GenAI

  • Kho 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 đến 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à các thư viện được đề xuất để truy cập vào Gemini API. Các thư viện này ổn định, được hỗ trợ đầy đủ cho việc sử dụng trong quá trình sản xuất và được duy trì tích cực. Các thư viện 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 quả 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ể truy cập vào các tính năng mới nhất và có được hiệu suất tốt nhất khi hoạt động với Gemini. Hãy xem phần 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à 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 từng 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 được đề xuất
Python google-generativeai Không được duy trì tích cực google-genai
JavaScript/TypeScript @google/generativeai Không được duy trì tích cực @google/genai
Go google.golang.org/generative-ai Không được duy trì tích cực google.golang.org/genai
Dart và Flutter google_generative_ai Không được duy trì tích cực Sử dụng Genkit Dart hoặc Firebase AI Logic
Swift generative-ai-swift Không được duy trì tích cực Sử dụng Firebase AI Logic
Android generative-ai-android Không được duy trì tích cực 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 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.