Guida rapida all'API Gemini

Questa guida rapida mostra come iniziare a utilizzare l'API Gemini con l'SDK scelto.

Python Node.js Go Dart (Flutter) Android Swift Web REST

Prerequisiti

Questa guida rapida presuppone che tu abbia dimestichezza con l'utilizzo di Android Studio per sviluppare app per Android.

Per completare questa guida introduttiva, assicurati che l'ambiente di sviluppo e l'app Android soddisfino i seguenti requisiti:

• Android Studio (versione più recente)
• La tua app per Android deve avere il livello API target 21 o versioni successive.

Valuta la possibilità di accedere a Gemini on-device

L'SDK client per Android descritto in questo tutorial ti consente di accedere ai modelli Gemini che vengono eseguiti sui server di Google. Per i casi d'uso che prevedono l'elaborazione di dati sensibili, la disponibilità offline o il risparmio sui costi per i flussi utente di uso frequente, ti consigliamo di valutare la possibilità di accedere a Gemini Nano, che funziona sul dispositivo. Per maggiori dettagli, consulta la pagina Android (sul dispositivo).

Installa l'SDK dell'API Gemini

1. Nel file di configurazione Gradle del modulo (a livello di app) (ad esempio <project>/<app-module>/build.gradle.kts), aggiungi la dipendenza per l'SDK Google AI per Android:

   Kotlin

   dependencies {
   
     // add the dependency for the Google AI client SDK for Android
     implementation("com.google.ai.client.generativeai:generativeai:0.7.0")
   }
   

   Java

   Per Java, devi aggiungere altre due librerie.

   dependencies {
   
       // add the dependency for the Google AI client SDK for Android
       implementation("com.google.ai.client.generativeai:generativeai:0.7.0")
   
       // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
       implementation("com.google.guava:guava:31.0.1-android")
   
       // Required for streaming operations (to use `Publisher` from Reactive Streams)
       implementation("org.reactivestreams:reactive-streams:1.0.4")
   }
   

2. Sincronizza il tuo progetto Android con i file Gradle.

Configura l'autenticazione

Il modo più semplice per autenticarsi all'API Gemini è configurare una chiave API, come descritto in questa sezione. Se hai bisogno di controlli di accesso più rigidi, puoi utilizzare OAuth.

Se non hai ancora una chiave API, creane una in Google AI Studio.

Ottenere una chiave API da Google AI Studio

Dopodiché, configura la chiave.

Ti consigliamo vivamente di non inserire una chiave API nel tuo sistema di controllo della versione. Dovresti invece archiviarla in un file local.properties (che si trova nella directory root del progetto, ma escluso dal controllo della versione), quindi utilizzare il plug-in Secrets Gradle per Android per leggere la chiave API come variabile di configurazione della build.

// Access your API key as a Build Configuration variable
val apiKey = BuildConfig.apiKey

// Access your API key as a Build Configuration variable
String apiKey = BuildConfig.apiKey;

Se vuoi vedere l'implementazione del plug-in Gradle Secrets, puoi esaminare l'app di esempio per questo SDK o utilizzare l'anteprima più recente di Android Studio Iguana, che include un modello di avvio dell'API Gemini (che include il file local.properties per iniziare).

Importa la libreria

Importa la libreria di IA generativa di Google.

// other imports...
import com.google.ai.client.generativeai.GenerativeModel

// other imports...
import com.google.ai.client.generativeai.GenerativeModel;
import com.google.ai.client.generativeai.java.GenerativeModelFutures;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.type.GenerateContentResponse;

Effettua la tua prima richiesta

Utilizza il metodo generateContent per generare il testo.

    val generativeModel =
    GenerativeModel(
        // Specify a Gemini model appropriate for your use case
        modelName = "gemini-1.5-flash",
        // Access your API key as a Build Configuration variable (see "Set up your API key" above)
        apiKey = BuildConfig.apiKey)

val prompt = "Write a story about a magic backpack."
val response = generativeModel.generateContent(prompt)
print(response.text)
text_generation.kt

    // Specify a Gemini model appropriate for your use case
GenerativeModel gm =
    new GenerativeModel(
        /* modelName */ "gemini-1.5-flash",
        // Access your API key as a Build Configuration variable (see "Set up your API key"
        // above)
        /* apiKey */ BuildConfig.apiKey);
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

Content content =
    new Content.Builder().addText("Write a story about a magic backpack.").build();

// For illustrative purposes only. You should use an executor that fits your needs.
Executor executor = Executors.newSingleThreadExecutor();

ListenableFuture<GenerateContentResponse> response = model.generateContent(content);
Futures.addCallback(
    response,
    new FutureCallback<GenerateContentResponse>() {
      @Override
      public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
      }

      @Override
      public void onFailure(Throwable t) {
        t.printStackTrace();
      }
    },
    executor);
text_generation.java

Passaggi successivi

Ora che hai configurato l'invio di richieste all'API Gemini, puoi utilizzare l'intera gamma di funzionalità dell'API Gemini per creare le tue app e i tuoi flussi di lavoro. Per iniziare a utilizzare le funzionalità dell'API Gemini, consulta le seguenti guide:

• Generare testo
• Vision
• Audio
• Contesto lungo

Per una documentazione dettagliata dei metodi e dei parametri di richiesta dell'API Gemini, consulta le guide nel riferimento API.