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

Libreria: google-genai
Repository GitHub: googleapis/python-genai
Installazione: pip install google-genai

JavaScript

Libreria: @google/genai
Repository GitHub: googleapis/js-genai
Installazione: npm install @google/genai

Go

Libreria: google.golang.org/genai
Repository GitHub: googleapis/go-genai
Installazione: go get google.golang.org/genai

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#

Libreria: Google.GenAI
Repository GitHub: googleapis/dotnet-genai
Installazione: dotnet add package Google.GenAI

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 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 tramite 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 è necessaria la migrazione da una libreria Google precedente. Puoi iniziare direttamente con la nuova libreria nella sezione Supporto e installazione delle lingue.

Modelli di prompt per la generazione di codice

Modelli generativi (ad es. Gemini, Claude) e IDE basati sull'AI (ad es. Cursor) potrebbe produrre codice per l'API Gemini utilizzando librerie obsolete o ritirate a causa della data limite dei dati di addestramento. Per fare in modo che il codice generato utilizzi le librerie più recenti e consigliate, fornisci indicazioni sulla versione e sull'utilizzo direttamente nei prompt. Puoi utilizzare i modelli riportati di seguito per fornire il contesto necessario: