Guide de démarrage rapide de l'API Gemini

Ce guide de démarrage rapide vous explique comment commencer à utiliser l'API Gemini à l'aide du SDK de votre choix.

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

Prérequis

Dans ce guide, nous partons du principe que vous savez utiliser Android Studio pour développer des applications Android.

Pour suivre ce guide de démarrage rapide, assurez-vous que votre environnement de développement et votre application Android répondent aux exigences suivantes :

• Android Studio (dernière version)
• Votre application Android doit cibler le niveau d'API 21 ou supérieur.

Envisagez d'accéder à Gemini sur l'appareil

Le SDK client pour Android décrit dans ce tutoriel vous permet d'accéder aux modèles Gemini qui s'exécutent sur les serveurs Google. Pour les cas d'utilisation impliquant le traitement de données sensibles, la disponibilité hors connexion ou les économies de coûts pour les flux utilisateur fréquemment utilisés, vous pouvez envisager d'accéder à Gemini Nano, qui s'exécute sur l'appareil. Pour en savoir plus, consultez la page Android (sur l'appareil).

Installer le SDK de l'API Gemini

1. Dans votre fichier de configuration Gradle module (au niveau de l'application) (comme <project>/<app-module>/build.gradle.kts), ajoutez la dépendance pour le SDK Google AI pour 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

   Pour Java, vous devez ajouter deux bibliothèques supplémentaires.

   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. Synchronisez votre projet Android avec les fichiers Gradle.

Configurer l'authentification

Le moyen le plus simple d'authentifier une application auprès de l'API Gemini consiste à configurer une clé API, comme décrit dans cette section. Si vous avez besoin de contrôles d'accès plus stricts, vous pouvez utiliser OAuth à la place.

Si vous ne possédez pas encore de clé API, créez-en une dans Google AI Studio.

Obtenir une clé API depuis Google AI Studio

Configurez ensuite votre clé.

Nous vous recommandons vivement de ne pas vérifier une clé API dans votre système de contrôle des versions. Vous devez plutôt la stocker dans un fichier local.properties (qui se trouve dans le répertoire racine de votre projet, mais qui est exclu du contrôle des versions), puis utiliser le plug-in Secrets Gradle pour Android pour lire votre clé API en tant que variable de configuration de compilation.

// 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;

Si vous souhaitez voir l'implémentation du plug-in Secrets Gradle, vous pouvez consulter l'application exemple de ce SDK ou utiliser la dernière version preview d'Android Studio Iguana, qui propose un modèle Gemini API Starter (qui inclut le fichier local.properties pour vous aider à démarrer).

Importer la bibliothèque

Importez la bibliothèque Google d'IA générative.

// 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;

Faites votre première demande

Utilisez la méthode generateContent pour générer du texte.

    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

Étape suivante

Maintenant que vous êtes prêt à envoyer des requêtes à l'API Gemini, vous pouvez utiliser toutes ses fonctionnalités pour créer vos applications et vos workflows. Pour commencer à utiliser les fonctionnalités de l'API Gemini, consultez les guides suivants:

• Génération de texte
• Vision
• Audio
• Contexte long

Pour une documentation détaillée sur les méthodes et les paramètres de requête de l'API Gemini, consultez les guides de la documentation de référence de l'API.