Biblioteki Gemini API

Podczas tworzenia aplikacji za pomocą interfejsu Gemini API zalecamy korzystanie z pakietu Google GenAI SDK. Są to oficjalne biblioteki gotowe do użycia w środowisku produkcyjnym, które tworzymy i utrzymujemy w przypadku najpopularniejszych języków. Są one w Ogólnej Dostępności i używane we wszystkich naszych oficjalnych dokumentach i przykładach.

Jeśli dopiero zaczynasz korzystać z interfejsu Gemini API, zapoznaj się z naszym przewodnikiem szybkiego startu.

Obsługa języków i instalacja

Pakiet Google GenAI SDK 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 uzyskać więcej informacji:

Python

JavaScript

Go

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>

C#

  • Biblioteka: Google.GenAI

  • Repozytorium GitHub: googleapis/dotnet-genai

  • Instalacja: dotnet add package Google.GenAI

Ogólna dostępność

Od maja 2025 r. pakiet Google GenAI SDK jest ogólnie dostępny na wszystkich obsługiwanych platformach i jest zalecaną biblioteką do uzyskiwania dostępu do interfejsu Gemini API. Jest stabilny, w pełni obsługiwany w środowisku produkcyjnym i aktywnie utrzymywany. Zapewnia 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ą wycofywane z dniem 30 listopada 2025 r.

Stan obsługi każdej starszej biblioteki jest inny. Szczegółowe informacje znajdziesz w tabeli poniżej:

Język Starsza biblioteka Stan obsługi Zalecana biblioteka
Python google-generativeai Nie jest aktywnie utrzymywana google-genai
JavaScript/TypeScript @google/generativeai Nie jest aktywnie utrzymywana @google/genai
Go google.golang.org/generative-ai Nie jest aktywnie utrzymywana google.golang.org/genai
Dart i Flutter google_generative_ai Nie jest aktywnie utrzymywana Użyj Genkit Dart lub Firebase AI Logic
Swift generative-ai-swift Nie jest aktywnie utrzymywana Użyj Firebase AI Logic
Android generative-ai-android Nie jest aktywnie utrzymywana Użyj Firebase AI Logic

Uwaga dla programistów w Javie: nie było starszego pakietu Java SDK dostarczonego 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 opisanej w sekcji Obsługa języków i instalacja.