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.
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.
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.
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.
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.
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.
Langkah 1: Siapkan project Firebase dan aktifkan API
Login ke konsol Firebase, lalu pilih project Firebase Anda.
Di konsol Firebase, buka AI Services > AI Logic.
Klik Mulai untuk meluncurkan alur kerja terpandu yang membantu Anda menyiapkan API dan resource yang diperlukan untuk project Anda.
Jika diminta, ikuti petunjuk di layar untuk mendaftarkan aplikasi dan menambahkan konfigurasi Firebase ke aplikasi.
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).
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.
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.
Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, buka File > Add Package Dependencies.
Saat diminta, tambahkan repositori SDK platform Apple Firebase:
https://github.com/firebase/firebase-ios-sdkPilih versi SDK terbaru.
Pilih library
FirebaseAILogicdan libraryFirebaseAppCheck.
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.
Instal Firebase JS SDK untuk Web menggunakan npm:
npm install firebaseInisialisasi 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.
Dari direktori project Flutter Anda, jalankan perintah berikut untuk menginstal plugin inti dan plugin Firebase AI Logic:
flutter pub add firebase_ai firebase_app_checkDalam 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';Selain itu, di file
lib/main.dart, pastikan Anda telah melakukan inisialisasi Firebase menggunakan objekDefaultFirebaseOptionsyang diekspor oleh file konfigurasi:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );Build ulang aplikasi Flutter Anda:
flutter run
Unity
Download Firebase Unity SDK, lalu ekstrak SDK ke tempat yang mudah diakses.
Firebase Unity SDK tidak bersifat khusus untuk platform tertentu.
Pada project Unity yang terbuka, buka Aset > Impor Paket > Paket Kustom.
Dari SDK yang diekstrak, pilih paket
FirebaseAIdan paketFirebaseAppCheck.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):
Di project Xcode, impor
FirebaseAppCheckdan lakukan inisialisasi App Check dengan factory penyedia debug sebelum Anda mengonfigurasiFirebase.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() } } } }Dapatkan token debug Anda:
Luncurkan aplikasi di simulator atau di perangkat pengujian Anda.
Buka konsol Xcode dan cari token debug App Check. Contoh:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Salin token (misalnya,
123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
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):
Pada build debug, konfigurasi App Check untuk menggunakan factory penyedia debug:
Firebase.initialize(context = this) Firebase.appCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance(), )
Dapatkan token debug Anda:
Jalankan aplikasi Anda di emulator atau di perangkat pengujian Anda.
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-789012345678Salin token (misalnya,
123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
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):
Pada build debug, konfigurasi App Check untuk menggunakan factory penyedia debug:
FirebaseApp.initializeApp(/*context=*/ this); FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance(); firebaseAppCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance());
Dapatkan token debug Anda:
Jalankan aplikasi Anda di emulator atau di perangkat pengujian Anda.
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-789012345678Salin token (misalnya,
123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
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):
Dalam build debug, aktifkan mode debug dengan menetapkan
self.FIREBASE_APPCHECK_DEBUG_TOKENketruesebelum Anda melakukan inisialisasi App Check. Contoh:self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });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.Daftarkan token debug Anda dengan App Check:
Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
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):
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()); }Aktifkan logging debug dalam project Xcode Anda:
- Buka Product > Scheme > Edit scheme.
- Pilih Run dari menu kiri, lalu pilih tab Arguments.
- Di bagian Arguments Passed on Launch, tambahkan
-FIRDebugEnabled.
Dapatkan token debug Anda:
Buka
ios/Runner.xcworkspacedengan Xcode dan jalankan aplikasi Anda di simulator atau di perangkat pengujian.Buka konsol Xcode dan cari token debug App Check. Contoh:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.Salin token (misalnya,
123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
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):
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()); }Dapatkan token debug Anda:
Jalankan aplikasi Anda di emulator atau di perangkat pengujian Anda.
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-789012345678Salin token (misalnya,
123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
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):
Dalam file
web/index.html, aktifkan mode debug dengan menetapkanself.FIREBASE_APPCHECK_DEBUG_TOKENketrue:<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>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_TOKENke string token, bukantrue.Daftarkan token debug Anda dengan App Check:
Di konsol Firebase, buka Keamanan > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
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):
Di konsol Firebase, buat token debug:
Di konsol Firebase, buka Security > App Check > tab Aplikasi.
Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
Ikuti petunjuk di layar untuk membuat token debug baru.
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 menampilkanListenableFuture.
// 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
- Pelajari lebih lanjut cara membuat teks dari perintah khusus teks, termasuk cara mengalirkan respons.
- Buat teks dengan memberikan perintah menggunakan berbagai jenis file, seperti gambar, PDF, video, dan audio.
- Bangun percakapan multi-turn (chat).
- Membuat output terstruktur (seperti JSON) dari prompt teks dan multimodal.
- Membuat dan mengedit gambar dari perintah teks dan multimodal.
- Input dan output streaming (termasuk audio) menggunakan Gemini Live API.
- Gunakan alat (seperti panggilan fungsi dan perujukan dengan Google Penelusuran) untuk menghubungkan model Gemini ke bagian lain aplikasi dan sistem serta informasi eksternal.
Mempelajari cara mengontrol pembuatan konten
- Pahami desain perintah, termasuk praktik terbaik, strategi, dan contoh perintah.
- Konfigurasi parameter model seperti token output maks, probabilitas token output berulang, dll.
- Gunakan setelan keamanan untuk menyesuaikan kemungkinan mendapatkan respons yang dapat dianggap berbahaya.
Memberikan masukan tentang pengalaman Anda dengan Firebase AI Logic