Librerie API Gemini

Quando crei con l'API Gemini, ti consigliamo di utilizzare l'SDK Google GenAI. Si tratta di librerie ufficiali e 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 oppure 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>

Disponibilità generale

Abbiamo iniziato a implementare Google GenAI SDK, un nuovo insieme di librerie per accedere all'API Gemini, alla fine del 2024, quando abbiamo lanciato Gemini 2.0.

A maggio 2025 hanno raggiunto la disponibilità generale (GA) su tutte le piattaforme supportate e sono le librerie consigliate per accedere all'API Gemini. Sono stabili, completamente supportati per l'uso operativo 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 in un percorso di ritiro. Smetteranno di ricevere aggiornamenti il 30 novembre 2025, le lacune delle funzionalità aumenteranno e i potenziali bug potrebbero non essere più corretti.

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

Lingua Libreria legacy Stato del supporto Libreria consigliata
Python google-generativeai Tutto il supporto, incluse le correzioni di bug, termina il 30 novembre 2025. google-genai
JavaScript/TypeScript @google/generativeai Tutto il supporto, incluse le correzioni di bug, termina il 30 novembre 2025. @google/genai
Go google.golang.org/generative-ai Tutto il supporto, incluse le correzioni di bug, termina il 30 novembre 2025. 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 precedente 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 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: