Panduan memulai Gemini API

Panduan memulai ini menunjukkan cara mulai menggunakan Gemini API menggunakan SDK pilihan Anda.

Prasyarat

Panduan memulai ini mengasumsikan bahwa Anda sudah terbiasa menggunakan Android Studio untuk mengembangkan aplikasi Android.

Untuk menyelesaikan panduan memulai ini, pastikan lingkungan pengembangan dan aplikasi Android Anda memenuhi persyaratan berikut:

Android Studio (versi terbaru)
Aplikasi Android Anda harus menargetkan API level 21 atau yang lebih tinggi.

Pertimbangkan untuk mengakses Gemini di perangkat

SDK klien untuk Android yang dijelaskan dalam tutorial ini memungkinkan Anda mengakses model Gemini yang berjalan di server Google. Untuk kasus penggunaan yang melibatkan pemrosesan data sensitif, ketersediaan offline, atau penghematan biaya bagi alur penggunaan yang sering digunakan, sebaiknya pertimbangkan untuk mengakses Gemini Nano yang berjalan di perangkat. Untuk mengetahui detail selengkapnya, lihat halaman Android (di perangkat).

Menginstal Gemini API SDK

Dalam file konfigurasi Gradle modul (level aplikasi) (seperti <project>/<app-module>/build.gradle.kts), tambahkan dependensi untuk Google AI SDK for 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

Untuk Java, Anda perlu menambahkan dua library tambahan.

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")
}

Sinkronkan project Android Anda dengan file Gradle.

Menyiapkan autentikasi

Cara termudah untuk melakukan autentikasi ke Gemini API adalah dengan mengonfigurasi kunci API, seperti yang dijelaskan di bagian ini. Jika memerlukan kontrol akses yang lebih ketat, Anda dapat menggunakan OAuth.

Jika Anda belum memiliki kunci API, buat kunci API di Google AI Studio.

Mendapatkan kunci API dari Google AI Studio

Kemudian, konfigurasikan kunci Anda.

Anda sebaiknya tidak melakukan check in kunci API ke sistem kontrol versi. Sebagai gantinya, sebaiknya simpan kunci API dalam file local.properties (yang terletak di direktori utama project, tetapi dikecualikan dari kontrol versi), lalu gunakan plugin Secrets Gradle untuk Android untuk membaca kunci API Anda sebagai variabel Konfigurasi Build.

Kotlin

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

Java

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

Jika ingin melihat penerapan plugin Gradle Secrets, Anda dapat meninjau aplikasi contoh untuk SDK ini atau menggunakan pratinjau terbaru Android Studio Iguana yang memiliki template Gemini API Starter (yang menyertakan file local.properties untuk memulai).

Mengimpor library

Impor library AI Generatif Google.

Kotlin

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

Java

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

Membuat permintaan pertama Anda

Gunakan metode generateContent untuk menghasilkan teks.

Kotlin

generateContent() adalah fungsi penangguhan dan perlu dipanggil dari cakupan Coroutine. Jika Anda tidak terbiasa dengan Coroutine, baca Coroutine Kotlin di Android.

    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

Java

generateContent() menampilkan ListenableFuture. Jika Anda tidak terbiasa dengan API ini, lihat dokumentasi Android tentang Menggunakan ListenableFuture.

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

Langkah berikutnya

Setelah menyiapkan permintaan ke Gemini API, Anda dapat menggunakan berbagai kemampuan Gemini API untuk membuat aplikasi dan alur kerja. Untuk mulai menggunakan kemampuan Gemini API, lihat panduan berikut:

Untuk dokumentasi metode dan parameter permintaan Gemini API yang mendalam, lihat panduan di referensi API.