Mulai menggunakan Gemini API menggunakan Firebase AI Logic SDK

Panduan ini menunjukkan cara mulai melakukan panggilan ke Gemini API langsung dari aplikasi Anda menggunakan SDK klien Firebase AI Logic untuk platform yang Anda pilih.

Prasyarat

Swift

Panduan ini mengasumsikan bahwa Anda sudah terbiasa menggunakan Xcode untuk mengembangkan aplikasi untuk platform Apple (seperti iOS).

Pastikan lingkungan pengembangan dan aplikasi platform Apple Anda memenuhi persyaratan berikut:

  • Xcode 26.2 atau yang lebih baru
  • Aplikasi Anda menargetkan iOS 15 atau yang lebih baru, atau macOS 12 atau yang lebih baru

Kotlin

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

Pastikan lingkungan pengembangan dan aplikasi Android Anda memenuhi persyaratan berikut:

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

Java

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

Pastikan lingkungan pengembangan dan aplikasi Android Anda memenuhi persyaratan berikut:

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

Web

Panduan ini mengasumsikan bahwa Anda sudah terbiasa menggunakan JavaScript untuk mengembangkan aplikasi web. Panduan ini tidak bergantung pada framework.

Pastikan lingkungan pengembangan dan aplikasi web Anda memenuhi persyaratan berikut:

  • (Opsional) Node.js
  • Browser web modern

Dart

Panduan ini mengasumsikan bahwa Anda sudah terbiasa mengembangkan aplikasi dengan Flutter.

Pastikan lingkungan pengembangan dan aplikasi Flutter Anda memenuhi persyaratan berikut:

  • Dart 3.2.0+

Unity

Panduan ini mengasumsikan bahwa Anda sudah terbiasa mengembangkan game dengan Unity.

Pastikan lingkungan pengembangan dan game Unity Anda memenuhi persyaratan berikut:

  • Unity Editor 2021 LTS atau yang lebih baru

Lihat referensi bermanfaat

Swift

Mencoba aplikasi panduan memulai

Gunakan aplikasi panduan memulai untuk mencoba SDK dengan cepat dan melihat penerapan lengkap berbagai kasus penggunaan. Atau gunakan aplikasi panduan memulai jika Anda tidak memiliki aplikasi platform Apple sendiri. Untuk menggunakan aplikasi panduan memulai, Anda harus menghubungkannya ke project Firebase.

Buka aplikasi panduan memulai

Menonton video tutorial

Video ini menunjukkan cara memulai Firebase AI Logic dengan membuat aplikasi perencanaan makanan yang didukung AI di dunia nyata yang membuat resep dari perintah teks.

Anda juga dapat mendownload dan mempelajari codebase untuk aplikasi dalam video.

Melihat codebase untuk aplikasi video



Kotlin

Mencoba aplikasi panduan memulai

Gunakan aplikasi panduan memulai untuk mencoba SDK dengan cepat dan melihat penerapan lengkap berbagai kasus penggunaan. Atau gunakan aplikasi quickstart jika Anda tidak memiliki aplikasi Android sendiri. Untuk menggunakan aplikasi quickstart, Anda harus menghubungkannya ke project Firebase.

Buka aplikasi panduan memulai

Menonton video tutorial

Video ini menunjukkan cara memulai Firebase AI Logic dengan membuat aplikasi perencanaan makanan yang didukung AI di dunia nyata yang membuat resep dari perintah teks.

Anda juga dapat mendownload dan mempelajari codebase untuk aplikasi dalam video.

Melihat codebase untuk aplikasi video



Java

Mencoba aplikasi panduan memulai

Gunakan aplikasi panduan memulai untuk mencoba SDK dengan cepat dan melihat penerapan lengkap berbagai kasus penggunaan. Atau gunakan aplikasi quickstart jika Anda tidak memiliki aplikasi Android sendiri. Untuk menggunakan aplikasi quickstart, Anda harus menghubungkannya ke project Firebase.

Buka aplikasi panduan memulai

Menonton video tutorial

Video ini menunjukkan cara memulai Firebase AI Logic dengan membuat aplikasi perencanaan makanan berteknologi AI di dunia nyata yang membuat resep dari perintah teks.*

Anda juga dapat mendownload dan mempelajari codebase untuk aplikasi dalam video.

Melihat codebase untuk aplikasi video

* Video dan aplikasinya ini menggunakan Kotlin, tetapi masih dapat membantu developer Java memahami dasar-dasar cara memulai penggunaan Firebase AI Logic.

Web

Mencoba aplikasi panduan memulai

Gunakan aplikasi panduan memulai untuk mencoba SDK dengan cepat dan melihat penerapan lengkap berbagai kasus penggunaan. Atau gunakan aplikasi panduan memulai jika Anda tidak memiliki aplikasi web sendiri. Untuk menggunakan aplikasi panduan memulai, Anda harus menghubungkannya ke project Firebase.

Buka aplikasi panduan memulai

Dart

Mencoba aplikasi panduan memulai

Gunakan aplikasi panduan memulai untuk mencoba SDK dengan cepat dan melihat penerapan lengkap berbagai kasus penggunaan. Atau, gunakan aplikasi panduan memulai jika Anda tidak memiliki aplikasi Flutter sendiri. Untuk menggunakan aplikasi panduan memulai, Anda harus menghubungkannya ke project Firebase.

Buka aplikasi panduan memulai

Menonton video tutorial

Video ini menunjukkan cara memulai Firebase AI Logic dengan membuat aplikasi perencanaan makanan yang didukung AI di dunia nyata yang membuat resep dari perintah teks.

Anda juga dapat mendownload dan mempelajari codebase untuk aplikasi dalam video.

Melihat codebase untuk aplikasi video



Unity

Mencoba aplikasi panduan memulai

Gunakan aplikasi panduan memulai untuk mencoba SDK dengan cepat dan melihat penerapan lengkap berbagai kasus penggunaan. Atau gunakan aplikasi panduan memulai jika Anda tidak memiliki game Unity sendiri. Untuk menggunakan aplikasi mulai cepat, Anda harus menghubungkannya ke project Firebase.

Buka aplikasi panduan memulai

Langkah 1: Siapkan project Firebase dan aktifkan API

  1. Login ke konsol Firebase, lalu pilih project Firebase Anda.

  2. Di konsol Firebase, buka AI Services > AI Logic.

  3. Klik Mulai untuk meluncurkan alur kerja terpandu yang membantu Anda menyiapkan API dan resource yang diperlukan untuk project Anda.

  4. Jika diminta, ikuti petunjuk di layar untuk mendaftarkan aplikasi dan menambahkan konfigurasi Firebase ke aplikasi.

  5. Saat diminta untuk memilih "penyedia Gemini API", sebaiknya pilih Gemini Developer API, yang memungkinkan Anda memulai dengan cepat tanpa biaya.

    Kapan pun setelahnya, Anda selalu dapat menyiapkan Vertex AI Gemini API (dan persyaratan penagihannya).

  6. Lanjutkan alur kerja untuk menyiapkan API yang diperlukan dan layanan terkait untuk Firebase AI Logic.

    Mulai awal Juli 2026, tahap alur kerja ini akan otomatis menerapkan Firebase App Check untuk AI Logic, yang merupakan layanan penting untuk membantu melindungi Gemini API saat diakses langsung dari aplikasi Anda. Sebagai bagian dari langkah-langkah memulai (lihat langkah-langkah selanjutnya dalam panduan ini), Anda harus mengonfigurasi penyedia debug App Check untuk pengembangan lokal saat App Check diterapkan.

  7. Lanjutkan ke langkah berikutnya dalam panduan ini untuk menambahkan SDK yang diperlukan ke aplikasi Anda.

Langkah 2: Tambahkan SDK yang diperlukan

Setelah project Firebase disiapkan dan API yang diperlukan diaktifkan (lihat langkah sebelumnya), Anda kini dapat menambahkan SDK yang diperlukan ke aplikasi Anda.

Swift

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase. Pelajari opsi penginstalan lainnya, jika diperlukan.

Library Firebase AI Logic menyediakan akses ke API untuk berinteraksi dengan model Gemini. Library ini disertakan sebagai bagian dari Firebase SDK untuk platform Apple (firebase-ios-sdk).

Jika Anda sudah menggunakan Firebase, pastikan paket Firebase Anda adalah v12.5.0 atau yang lebih baru.

  1. Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, buka File > Add Package Dependencies.

  2. Saat diminta, tambahkan repositori SDK platform Apple Firebase:

    https://github.com/firebase/firebase-ios-sdk
    
  3. Pilih versi SDK terbaru.

  4. Pilih library FirebaseAILogic dan library FirebaseAppCheck.

Setelah selesai, Xcode akan otomatis mulai me-resolve dan mendownload dependensi Anda di latar belakang.

Kotlin

Firebase AI Logic SDK for Android (firebase-ai) menyediakan akses ke API untuk berinteraksi dengan model Gemini.

Dalam file Gradle modul (level aplikasi) (seperti <project>/<app-module>/build.gradle.kts), tambahkan dependensi untuk library Firebase AI Logic untuk Android. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.

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

Dengan menggunakan Firebase Android BoM, aplikasi Anda akan selalu menggunakan versi library Android Firebase yang kompatibel.

Java

Firebase AI Logic SDK for Android (firebase-ai) menyediakan akses ke API untuk berinteraksi dengan model Gemini.

Dalam file Gradle modul (level aplikasi) (seperti <project>/<app-module>/build.gradle.kts), tambahkan dependensi untuk library Firebase AI Logic untuk Android. Sebaiknya gunakan Firebase Android BoM untuk mengontrol pembuatan versi library.

Untuk Java, Anda perlu menambahkan dua library tambahan.

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

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

Dengan menggunakan Firebase Android BoM, aplikasi Anda akan selalu menggunakan versi library Android Firebase yang kompatibel.

Web

Library Firebase AI Logic menyediakan akses ke API untuk berinteraksi dengan model Gemini. Library ini disertakan sebagai bagian dari Firebase JavaScript SDK untuk Web.

  1. Instal Firebase JS SDK untuk Web menggunakan npm:

    npm install firebase
    
  2. Inisialisasi Firebase di aplikasi Anda:

    import { initializeApp } from "firebase/app";
    import { initializeAppCheck, DebugProvider } from "firebase/app-check";
    
    // TODO(developer) Replace the following with your app's Firebase configuration
    // See: https://firebase.google.com/docs/web/learn-more#config-object
    const firebaseConfig = {
      // ...
    };
    
    // Initialize FirebaseApp
    const firebaseApp = initializeApp(firebaseConfig);
    

Dart

Plugin Firebase AI Logic untuk Flutter (firebase_ai) menyediakan akses ke API untuk berinteraksi dengan model Gemini.

  1. Dari direktori project Flutter Anda, jalankan perintah berikut untuk menginstal plugin inti dan plugin Firebase AI Logic:

    flutter pub add firebase_ai firebase_app_check
    
  2. Dalam file lib/main.dart, impor plugin Firebase AI Logic dan App Check:

    import 'package:firebase_core/firebase_core.dart';
    import 'package:firebase_ai/firebase_ai.dart';
    import 'package:firebase_app_check/firebase_app_check.dart';
    import 'firebase_options.dart';
    
  3. Selain itu, di file lib/main.dart, pastikan Anda telah melakukan inisialisasi Firebase menggunakan objek DefaultFirebaseOptions yang diekspor oleh file konfigurasi:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  4. Build ulang aplikasi Flutter Anda:

    flutter run
    

Unity

  1. Download Firebase Unity SDK, lalu ekstrak SDK ke tempat yang mudah diakses.

    Firebase Unity SDK tidak bersifat khusus untuk platform tertentu.

  2. Pada project Unity yang terbuka, buka Aset > Impor Paket > Paket Kustom.

  3. Dari SDK yang diekstrak, pilih paket FirebaseAI dan paket FirebaseAppCheck.

  4. Di jendela Import Unity Package, klik Import.

Langkah 3: Konfigurasi penyedia debug App Check untuk pengembangan lokal

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

Swift

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda di simulator secara interaktif (misalnya, selama pengembangan lokal):

  1. Di project Xcode, impor FirebaseAppCheck dan lakukan inisialisasi App Check dengan factory penyedia debug sebelum Anda mengonfigurasi Firebase.

    import SwiftUI
    import FirebaseCore
    import FirebaseAppCheck
    
    @main
    struct YourApp: App {
      init() {
        let providerFactory = AppCheckDebugProviderFactory()
        AppCheck.setAppCheckProviderFactory(providerFactory)
        FirebaseApp.configure()
      }
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
    
  2. Dapatkan token debug Anda:

    1. Luncurkan aplikasi di simulator atau di perangkat pengujian Anda.

    2. Buka konsol Xcode dan cari token debug App Check. Contoh:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      
    3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).

  3. Daftarkan token debug Anda dengan App Check:

    1. Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.

    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 App Check resmi.

Kotlin

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

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

    Firebase.initialize(context = this)
    Firebase.appCheck.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 dengan App Check:

    1. Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.

    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 App Check resmi.

Java

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

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

    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 dengan App Check:

    1. Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.

    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 App Check resmi.

Web

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda dari localhost secara interaktif (misalnya, selama pengembangan lokal):

  1. Dalam build debug, aktifkan mode debug dengan menetapkan self.FIREBASE_APPCHECK_DEBUG_TOKEN ke true sebelum Anda melakukan inisialisasi App Check. Contoh:

    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
    initializeAppCheck(app, { /* App Check options */ });
    
  2. Buka aplikasi web Anda secara lokal, lalu buka alat developer browser. Di konsol debug, Anda akan melihat token debug:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
    You will need to safelist it in the Firebase console for it to work.
    
  3. Daftarkan token debug Anda dengan App Check:

    1. Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.

    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 App Check resmi.

Dart

iOS+

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda di simulator secara interaktif (misalnya, selama pengembangan lokal):

  1. Aktifkan App Check dengan penyedia debug tepat setelah Anda menginisialisasi aplikasi Firebase:

    import 'package:flutter/material.dart';
    import 'package:firebase_core/firebase_core.dart';
    
    // Import the firebase_app_check plugin
    import 'package:firebase_app_check/firebase_app_check.dart';
    
    Future<void> main() async {
      WidgetsFlutterBinding.ensureInitialized();
      await Firebase.initializeApp();
      await FirebaseAppCheck.instance.activate(
        // Set appleProvider to `AppleProvider.debug`
        appleProvider: AppleProvider.debug,
      );
      runApp(App());
    }
    
  2. Aktifkan logging debug dalam project Xcode Anda:

    1. Buka Product > Scheme > Edit scheme.
    2. Pilih Run dari menu kiri, lalu pilih tab Arguments.
    3. Di bagian Arguments Passed on Launch, tambahkan -FIRDebugEnabled.
  3. Dapatkan token debug Anda:

    1. Buka ios/Runner.xcworkspace dengan Xcode dan jalankan aplikasi Anda di simulator atau di perangkat pengujian.

    2. Buka konsol Xcode dan cari token debug App Check. Contoh:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      
    3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).

  4. Daftarkan token debug Anda dengan App Check:

    1. Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.

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

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

Android

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

  1. Aktifkan App Check dengan penyedia debug tepat setelah Anda menginisialisasi aplikasi Firebase:

    import 'package:flutter/material.dart';
    import 'package:firebase_core/firebase_core.dart';
    
    // Import the firebase_app_check plugin
    import 'package:firebase_app_check/firebase_app_check.dart';
    
    Future<void> main() async {
      WidgetsFlutterBinding.ensureInitialized();
      await Firebase.initializeApp();
      await FirebaseAppCheck.instance.activate(
        // Set androidProvider to `AndroidProvider.debug`
        androidProvider: AndroidProvider.debug,
      );
      runApp(App());
    }
    
  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 dengan App Check:

    1. Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.

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

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

Web

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda dari localhost secara interaktif (misalnya, selama pengembangan lokal):

  1. Dalam file web/index.html, aktifkan mode debug dengan menetapkan self.FIREBASE_APPCHECK_DEBUG_TOKEN ke true:

    <body>
      <script>
        self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
      </script>
    
      ...
    
    </body>
    
  2. Jalankan aplikasi web Anda secara lokal, lalu buka alat developer browser. Di konsol debug, Anda akan melihat token debug:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
    You will need to safelist it in the Firebase console for it to work.
    

    Token ini disimpan secara lokal di browser dan akan digunakan setiap kali Anda menggunakan aplikasi di browser yang sama pada mesin yang sama. Jika Anda ingin menggunakan token di browser lain atau di mesin lain, tetapkan self.FIREBASE_APPCHECK_DEBUG_TOKEN ke string token, bukan true.

  3. Daftarkan token debug Anda dengan App Check:

    1. Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.

    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 App Check resmi.

Unity

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

  1. Di konsol Firebase, buat token debug:

    1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.

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

    3. Ikuti petunjuk di layar untuk membuat token debug baru.

  2. Dalam kode inisialisasi aplikasi Anda, tambahkan kode berikut:

    using Firebase.AppCheck;
    
    void InitializeFirebase() {
      // Configure the Debug Provider factory with your debug token.
      DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");
    
      // Set App Check to use the debug provider factory
      FirebaseAppCheck.SetAppCheckProviderFactory(
        DebugAppCheckProviderFactory.Instance);
    
      // Proceed to initialize Firebase as normal
    }
    

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

Langkah 4: Inisialisasi layanan dan buat instance model

Klik penyedia Gemini API untuk melihat konten dan kode khusus penyedia di halaman ini.

Sebelum mengirim perintah ke model Gemini, inisialisasi layanan untuk penyedia API yang Anda pilih dan buat instance GenerativeModel.

Swift


import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.5-flash")

Kotlin


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-3.5-flash")

Java


// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-3.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web


import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-3.5-flash" });

Dart


import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-3.5-flash');

Unity


using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

Perhatikan bahwa bergantung pada kemampuan yang Anda gunakan, Anda mungkin tidak selalu membuat instance GenerativeModel. Untuk mengalirkan input dan output menggunakan Gemini Live API, buat instance LiveModel.

Selain itu, setelah Anda menyelesaikan panduan memulai ini, pelajari cara memilih model untuk kasus penggunaan dan aplikasi Anda.

Langkah 5: Kirim permintaan ke model

Anda kini telah siap untuk mengirim permintaan ke model Gemini.

Anda dapat menggunakan generateContent() untuk membuat teks dari perintah yang berisi teks:

Swift


import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")

Kotlin

Untuk Kotlin, metode dalam SDK ini adalah fungsi penangguhan dan perlu dipanggil dari cakupan Coroutine.

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-3.5-flash")

// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
val response = model.generateContent(prompt)
print(response.text)

Java

Untuk Java, metode dalam SDK ini menampilkan ListenableFuture.

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-3.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// Provide a prompt that contains text
Content prompt = new Content.Builder()
    .addText("Write a story about a magic backpack.")
    .build();

// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
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);

Web


import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-3.5-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();

Dart


import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-3.5-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

Unity


using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

// Provide a prompt that contains text
var prompt = "Write a story about a magic backpack.";

// To generate text output, call GenerateContentAsync with the text input
var response = await model.GenerateContentAsync(prompt);
UnityEngine.Debug.Log(response.Text ?? "No text in response.");

Kamu bisa apa lagi?

Pelajari lebih lanjut model yang didukung

Pelajari model yang tersedia untuk berbagai kasus penggunaan serta kuota dan harganya.

Mencoba kemampuan lain

Mempelajari cara mengontrol pembuatan konten

Anda juga dapat bereksperimen dengan perintah dan konfigurasi model, bahkan mendapatkan cuplikan kode yang dihasilkan menggunakan Google AI Studio.


Memberikan masukan tentang pengalaman Anda dengan Firebase AI Logic