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 w przypadku najpopularniejszych języków. Są one ogólnie dostępne 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 interfejsu 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ą one stabilne, w pełni obsługiwane w środowisku produkcyjnym i aktywnie utrzymywane. Zapewniają dostęp do najnowszych funkcji i oferują najlepszą wydajność podczas pracy z Gemini.

Jeśli używasz jednej z naszych starszych bibliotek, zdecydowanie zalecamy migrację, aby uzyskać dostęp do najnowszych funkcji i najlepszej wydajności 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. 30 listopada 2025 r. przestaną otrzymywać aktualizacje, 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ę 30 listopada 2025 r. google-genai
JavaScript/TypeScript @google/generativeai Cała pomoc, w tym poprawki błędów, zakończy się 30 listopada 2025 r. @google/genai
Go google.golang.org/generative-ai Cała pomoc, w tym poprawki błędów, zakończy się 30 listopada 2025 r. 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 dostarczonego przez Google dla interfejsu Gemini API, więc nie jest wymagana migracja z poprzedniej biblioteki Google. Możesz od razu zacząć od nowej biblioteki w sekcji Obsługiwane języki i instalacja.

Szablony promptów do generowania kodu

modele generatywne (np. Gemini, Claude) i IDE oparte na AI (np. Cursor) może generować kod dla interfejsu Gemini API przy użyciu przestarzałych lub wycofanych bibliotek ze względu na datę odcięcia danych szkoleniowych. Aby wygenerowany kod korzystał z najnowszych, zalecanych bibliotek, podaj w promptach wskazówki dotyczące wersji i użycia. Aby podać niezbędny kontekst, możesz użyć poniższych szablonów: