Biblioteki Gemini API

Podczas tworzenia aplikacji z użyciem interfejsu Gemini API zalecamy korzystanie z naszej oficjalnej kolekcji bibliotek w najpopularniejszych językach – Google GenAI SDK. Są one gotowe do wdrożenia w środowisku produkcyjnym w ramach ogólnej dostępności. Przykłady i dokumentacja w tej witrynie są oparte na tych bibliotekach.

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ść

Pakiet Google GenAI SDK zaczęliśmy wdrażać pod koniec 2024 r. W maju 2025 r. usługa została udostępniona w ramach ogólnej dostępności na wszystkich obsługiwanych platformach. Oznacza to, że biblioteki są stabilne i w pełni obsługiwane w przypadku użycia produkcyjnego. Są one aktywnie rozwijane, zapewniają dostęp do najnowszych funkcji i oferują najlepszą wydajność podczas pracy z Gemini.

Jeśli nie używasz pakietu Google GenAI SDK, ale korzystasz z jednej z naszych starszych bibliotek, zdecydowanie zalecamy migrację. 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 Gemini w Firebase
Android generative-ai-android Nie jest aktywnie utrzymywany Korzystanie z Gemini w Firebase

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.