Gemini API – Kurzanleitung

In dieser Kurzanleitung erfahren Sie, wie Sie mit dem SDK Ihrer Wahl die ersten Schritte mit der Gemini API machen.

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

Vorbereitung

In dieser Kurzanleitung wird davon ausgegangen, dass Sie mit der Entwicklung von Android-Apps mit Android Studio vertraut sind.

Damit Sie diese Kurzanleitung ausführen können, müssen Ihre Entwicklungsumgebung und Ihre Android-App die folgenden Anforderungen erfüllen:

• Android Studio (aktuelle Version)
• Ihre Android-App muss auf API-Level 21 oder höher ausgerichtet sein.

Auf Gemini auf dem Gerät zugreifen

Mit dem in dieser Anleitung beschriebenen Client SDK for Android können Sie auf die Gemini-Modelle zugreifen, die auf den Servern von Google ausgeführt werden. Für Anwendungsfälle, bei denen vertrauliche Daten verarbeitet werden, Offlineverfügbarkeit erforderlich ist oder Kosteneinsparungen bei häufig verwendeten Nutzerflüssen erzielt werden sollen, können Sie Gemini Nano verwenden, das auf dem Gerät ausgeführt wird. Weitere Informationen finden Sie auf der Seite Android (On-Device).

Google AI SDK installieren

1. Fügen Sie in der Gradle-Konfigurationsdatei Ihres Moduls (auf App-Ebene) (z. B. <project>/<app-module>/build.gradle.kts) die Abhängigkeit für das Google AI SDK for Android hinzu:

   Kotlin

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

   Java

   Für Java müssen Sie zwei zusätzliche Bibliotheken hinzufügen.

   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. Synchronisieren Sie Ihr Android-Projekt mit Gradle-Dateien.

Authentifizierung einrichten

Die einfachste Möglichkeit, sich bei der Gemini API zu authentifizieren, ist die Konfiguration eines API-Schlüssels, wie in diesem Abschnitt beschrieben. Wenn Sie strengere Zugriffssteuerungen benötigen, können Sie stattdessen OAuth verwenden.

Wenn Sie noch keinen API-Schlüssel haben, erstellen Sie einen in Google AI Studio.

API-Schlüssel in Google AI Studio abrufen

Konfigurieren Sie dann den Schlüssel.

Wir empfehlen dringend, einen API-Schlüssel nicht in Ihr Versionsverwaltungssystem einzuchecken. Speichern Sie ihn stattdessen in einer local.properties-Datei, die sich im Stammverzeichnis Ihres Projekts befindet, aber von der Versionskontrolle ausgeschlossen ist. Verwenden Sie dann das Secrets Gradle-Plug-in für Android, um den API-Schlüssel als Build-Konfigurationsvariable zu lesen.

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

Wenn Sie sich die Implementierung des Secrets Gradle-Plug-ins ansehen möchten, können Sie sich die Beispiel-App für dieses SDK ansehen oder die neueste Vorabversion von Android Studio Iguana verwenden, die eine Gemini API Starter-Vorlage enthält (mit der local.properties-Datei als Ausgangspunkt).

Bibliothek importieren

Importieren Sie die generative KI-Bibliothek von 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;

Erste Anfrage stellen

Verwenden Sie die Methode generateContent, um Text zu generieren.

    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

Nächste Schritte

Nachdem Sie Anfragen an die Gemini API gesendet haben, können Sie die gesamte Palette der Gemini API-Funktionen nutzen, um Ihre Apps und Workflows zu erstellen. In den folgenden Anleitungen erfahren Sie, wie Sie die Funktionen der Gemini API nutzen:

• Textgenerierung
• Vision
• Audio
• Langer Kontext

Eine ausführliche Dokumentation der Gemini API-Methoden und -Anfrageparameter finden Sie in den Anleitungen in der API-Referenz.