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 utilizzati in tutta la nostra documentazione ed esempi ufficiali.

Se non hai mai utilizzato l'API Gemini, segui 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 lingua utilizzando i gestori di pacchetti o visitare i relativi repository GitHub per ulteriori informazioni:

Python

JavaScript

Go

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 su tutte le piattaforme supportate e sono le librerie consigliate per accedere all'API Gemini. Sono stabili, completamente supportati per l'uso in produzione e vengono gestiti attivamente. Forniscono l'accesso alle funzionalità più recenti e offrono le migliori prestazioni con Gemini.

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

Librerie legacy e migrazione

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

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

Lo stato di supporto di ogni libreria precedente varia, come descritto in dettaglio nella tabella seguente:

Lingua Libreria legacy Stato del supporto Raccolta consigliata
Python google-generativeai Non più sviluppato attivamente google-genai
JavaScript/TypeScript @google/generativeai Non più sviluppato attivamente @google/genai
Go google.golang.org/generative-ai Non più sviluppato attivamente google.golang.org/genai
Dart e Flutter google_generative_ai Non più sviluppato attivamente Utilizza librerie di community o di terze parti attendibili, come firebase_ai, o accedi utilizzando l'API REST
Swift generative-ai-swift Non più sviluppato attivamente Utilizzare Firebase AI Logic
Android generative-ai-android Non più sviluppato attivamente Utilizzare Firebase AI Logic

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