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
Biblioteka:
google-genai
Repozytorium GitHub: googleapis/python-genai
Instalacja:
pip install google-genai
JavaScript
Biblioteka:
@google/genai
Repozytorium GitHub: googleapis/js-genai
Instalacja:
npm install @google/genai
Przeczytaj
Biblioteka:
google.golang.org/genai
Repozytorium GitHub: googleapis/go-genai
Instalacja:
go get google.golang.org/genai
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.