Vertex AI Gemini API

Jika Anda baru menggunakan Gemini API, Gemini Developer API adalah penyedia API yang direkomendasikan untuk Developer Android. Namun, jika Anda memiliki persyaratan lokasi data tertentu atau sudah terintegrasi dalam lingkungan Vertex AI atau Google Cloud, Anda dapat menggunakan Vertex AI Gemini API.

Memulai

Sebelum berinteraksi dengan Vertex AI Gemini API langsung dari aplikasi, Anda dapat bereksperimen dengan perintah di Vertex AI Studio.

Menyiapkan project Firebase dan menghubungkan aplikasi Anda ke Firebase

Setelah siap memanggil API dari aplikasi, ikuti petunjuk di "Langkah 1" dalam panduan memulai Firebase AI Logic untuk menyiapkan Firebase dan mengaktifkan API serta layanan yang diperlukan.

Menambahkan dependensi Gradle

Tambahkan dependensi Gradle berikut ke modul aplikasi Anda:

Kotlin

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

Java

dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

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

Mengonfigurasi penyedia debug App Check untuk pengembangan lokal

Mulai awal Juli 2026, sebagai bagian dari alur kerja penyiapan terpandu untuk AI Logic di Firebase console, Firebase App Check akan otomatis diterapkan untuk melindungi Gemini API. Untuk pengembangan lokal, Anda perlu mengonfigurasi penyedia debug App Check untuk melewati pengesahan sambil tetap mempertahankan penerapan App Check.

  1. Pada build debug, konfigurasikan App Check untuk menggunakan factory penyedia debug:

    Kotlin

    Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    DebugAppCheckProviderFactory.getInstance(),
)

    Java

    FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance());

  2. Dapatkan token debug Anda:

    1. Jalankan aplikasi Anda di emulator atau di perangkat pengujian Anda.

    2. Cari token debug App Check di log Anda. Contoh:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

    3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).

  3. Daftarkan token debug Anda ke App Check:

    1. Di Firebase console, buka Security > App Check > Apps tab.

    2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.

    3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Untuk mengetahui detail tentang penyedia debug (termasuk cara mendapatkan token debug baru), lihat dokumen resmi App Check.

Menginisialisasi model generatif

Mulai dengan membuat instance GenerativeModel dan menentukan nama model:

Kotlin

val model = Firebase.ai(backend = GenerativeBackend.vertexAI())
    .generativeModel("gemini-2.5-flash")

Java

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.vertexAI())
        .generativeModel("gemini-2.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);

Dalam dokumentasi Firebase, Anda dapat mempelajari lebih lanjut model Gemini yang tersedia. Anda juga dapat mempelajari cara mengonfigurasi parameter model.

Buat teks

Untuk membuat respons teks, panggil generateContent() dengan perintah Anda.

Kotlin

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}

Java

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

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

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

Mirip dengan Gemini Developer API, Anda juga dapat meneruskan gambar, audio, video, dan file dengan perintah teks Anda. Untuk mengetahui detailnya, lihat Berinteraksi dengan Gemini Developer API dari aplikasi Anda.

Untuk mempelajari lebih lanjut Firebase AI Logic SDK, baca dokumentasi Firebase.