Biblioteki Gemini API

Podczas tworzenia aplikacji z użyciem interfejsu Gemini API zalecamy korzystanie z pakietu Google GenAI SDK. Są to oficjalne, gotowe do użycia biblioteki, które opracowujemy i utrzymujemy dla najpopularniejszych języków. Są one dostępne w wersji ogólnodostępnej i używane we wszystkich naszych oficjalnych dokumentach i przykładach.

Jeśli dopiero zaczynasz korzystać z interfejsu Gemini API, zapoznaj się z naszym krótkim przewodnikiem.

Obsługa języków i instalacja

Pakiet SDK Google GenAI jest dostępny w językach Python, JavaScript/TypeScript, Go i Java. Bibliotekę każdego języka możesz zainstalować za pomocą menedżerów pakietów lub odwiedzić repozytoria GitHub, aby dowiedzieć się więcej:

Python

JavaScript

Przeczytaj

Java

  • Biblioteka: google-genai

  • Repozytorium GitHub: googleapis/java-genai

  • Instalacja: jeśli używasz Maven, dodaj do zależności ten kod:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

Ogólna dostępność

Pod koniec 2024 r., gdy wprowadziliśmy Gemini 2.0, zaczęliśmy wdrażać pakiet Google GenAI SDK, czyli nowy zestaw bibliotek umożliwiających dostęp do Gemini API.

W maju 2025 r. osiągnęły one ogólną dostępność na wszystkich obsługiwanych platformach i są zalecanymi bibliotekami do uzyskiwania dostępu do interfejsu Gemini API. Są stabilne, w pełni obsługiwane w środowisku produkcyjnym i aktywnie utrzymywane. Zapewniają dostęp do najnowszych funkcji i najlepszą wydajność podczas pracy z Gemini.

Jeśli używasz jednej z naszych starszych bibliotek, zdecydowanie zalecamy przejście na nową, aby mieć dostęp do najnowszych funkcji i uzyskać najlepszą wydajność podczas pracy z Gemini. Więcej informacji znajdziesz w sekcji starsze biblioteki.

Starsze biblioteki i migracja

Jeśli używasz jednej z naszych starszych bibliotek, zalecamy przejście na nowe biblioteki.

Starsze biblioteki nie zapewniają dostępu do najnowszych funkcji (takich jak Live API i Veo) i są w procesie wycofywania. Nie będą już otrzymywać aktualizacji po zakończeniu września 2025 r., a różnice w funkcjach będą się powiększać, a potencjalne błędy mogą nie być już naprawiane.

Stan obsługi każdej starszej biblioteki jest różny. Szczegółowe informacje znajdziesz w tej tabeli:

Język Starsza biblioteka Stan pomocy Zalecana biblioteka
Python google-generativeai Cała pomoc, w tym poprawki błędów, zakończy się pod koniec września 2025 roku. google-genai
JavaScript/TypeScript @google/generativeai Cała pomoc, w tym poprawki błędów, zakończy się pod koniec września 2025 roku. @google/genai
Go google.golang.org/generative-ai Cała pomoc, w tym poprawki błędów, zakończy się pod koniec września 2025 roku. google.golang.org/genai
Dart i Flutter google_generative_ai Nie jest aktywnie utrzymywany Korzystaj z zaufanych bibliotek społecznościowych lub bibliotek innych firm, takich jak firebase_ai, albo uzyskuj dostęp za pomocą interfejsu API REST.
Swift generative-ai-swift Nie jest aktywnie utrzymywany Korzystanie z Firebase AI Logic
Android generative-ai-android Nie jest aktywnie utrzymywany Korzystanie z Firebase AI Logic

Uwaga dla programistów Java: nie było starszego pakietu SDK Java dostarczanego przez Google dla interfejsu Gemini API, więc nie jest wymagana migracja z poprzedniej biblioteki Google. Możesz od razu zacząć korzystać z nowej biblioteki w sekcji Obsługa języków i instalacja.