Librerie API Gemini

Quando crei con l'API Gemini, ti consigliamo di utilizzare l'SDK Google GenAI. Si tratta delle librerie ufficiali, pronte per la produzione, che sviluppiamo e gestiamo per i linguaggi più diffusi. Sono in disponibilità generale e vengono utilizzate in tutta la nostra documentazione ed esempi ufficiali.

Se non hai mai utilizzato l'API Gemini, consulta la nostra guida rapida per iniziare.

Supporto delle lingue e installazione

L'SDK Google GenAI è disponibile per i linguaggi Python, JavaScript/TypeScript, Go e Java. Puoi installare la libreria di ogni linguaggio utilizzando i gestori di pacchetti o visitare i relativi repository GitHub per ulteriori informazioni:

Python

JavaScript

Vai

Java

  • Libreria: google-genai

  • Repository GitHub: googleapis/java-genai

  • Installazione: se utilizzi Maven, aggiungi quanto segue alle dipendenze:

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

C#

Disponibilità generale

A partire da maggio 2025, l'SDK Google GenAI ha raggiunto la disponibilità generale (GA) su tutte le piattaforme supportate ed è la libreria consigliata per accedere all'API Gemini. Sono stabili, completamente supportate per l'uso in produzione e vengono gestite attivamente. Forniscono l'accesso alle funzionalità più recenti e offrono le migliori prestazioni con Gemini.

Se utilizzi una delle nostre librerie precedenti, ti consigliamo vivamente di eseguire la migrazione per poter accedere alle funzionalità più recenti e ottenere le migliori prestazioni con Gemini. Per ulteriori informazioni, consulta la sezione Librerie precedenti.

Librerie precedenti e migrazione

Se utilizzi una delle nostre librerie precedenti, ti consigliamo di eseguire la migrazione alle nuove librerie.

Le librerie precedenti non forniscono l'accesso alle funzionalità recenti (come Live API e Veo) e sono ritirate a partire dal 30 novembre 2025.

Lo stato del supporto di ogni libreria precedente varia, come indicato nella tabella seguente:

Lingua Libreria precedente Stato del supporto Libreria consigliata
Python google-generativeai Non gestita attivamente google-genai
JavaScript/TypeScript @google/generativeai Non gestita attivamente @google/genai
Vai google.golang.org/generative-ai Non gestita attivamente google.golang.org/genai
Dart e Flutter google_generative_ai Non gestita attivamente Utilizza Genkit Dart o Firebase AI Logic
Swift generative-ai-swift Non gestita attivamente Utilizza Firebase AI Logic
Android generative-ai-android Non gestita attivamente Utilizza Firebase AI Logic

Nota per gli sviluppatori Java: non esisteva un SDK Java fornito da Google per l'API Gemini, quindi non è necessaria la migrazione da una libreria Google precedente. Puoi iniziare direttamente con la nuova libreria nella sezione Supporto delle lingue e installazione.