Panduan ini menunjukkan cara mulai melakukan panggilan ke Vertex AI Gemini API langsung dari aplikasi menggunakan Vertex AI in Firebase SDK untuk platform yang Anda pilih.
Opsi lain untuk menggunakan Gemini API
Secara opsional, bereksperimenlah dengan versi "Google AI" alternatif dari Gemini API
Dapatkan akses tanpa biaya (dalam batas dan jika tersedia) menggunakan Google AI Studio dan SDK klien Google AI. SDK ini harus digunakan untuk hanya membuat prototipe di aplikasi seluler dan web.Setelah Anda memahami cara kerja Gemini API, migrasikan ke Vertex AI in Firebase SDK kami (dokumentasi ini), yang memiliki banyak fitur tambahan yang penting untuk aplikasi seluler dan web, seperti melindungi API dari penyalahgunaan menggunakan Firebase App Check dan dukungan untuk file media berukuran besar dalam permintaan.
Secara opsional, panggil sisi server Vertex AI Gemini API (seperti dengan Python, Node.js, atau Go)
Gunakan SDK Vertex AI sisi server, Firebase Genkit, atau Firebase Extensions untuk Gemini API.
Perhatikan bahwa Anda juga dapat menggunakan panduan ini untuk mulai mengakses model Imagen menggunakan Vertex AI in Firebase SDK.
Prasyarat
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 Android Anda harus menargetkan API level 21 atau yang lebih tinggi.
(Opsional) Lihat aplikasi contoh.
Anda dapat mencoba SDK dengan cepat, melihat implementasi lengkap berbagai kasus penggunaan, atau menggunakan aplikasi contoh jika tidak memiliki aplikasi Android sendiri. Untuk menggunakan aplikasi contoh, Anda harus menghubungkannya ke project Firebase.
Langkah 1: Siapkan project Firebase dan hubungkan aplikasi Anda ke Firebase
Jika Anda sudah memiliki project Firebase dan aplikasi yang terhubung ke Firebase
Di Firebase console, buka halaman Build with Gemini.
Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas berikut:
Mengupgrade project Anda untuk menggunakan paket harga Blaze bayar sesuai penggunaan.
Aktifkan API yang diperlukan di project Anda (Vertex AI API dan Vertex AI in Firebase API).
Lanjutkan ke langkah berikutnya dalam panduan ini untuk menambahkan SDK ke aplikasi Anda.
Jika Anda belum memiliki project Firebase dan aplikasi yang terhubung ke Firebase
Menyiapkan project Firebase
Login ke Firebase console.
Klik Create project, lalu gunakan salah satu opsi berikut:
Opsi 1: Buat project Firebase yang sepenuhnya baru (dan project Google Cloud yang mendasarinya secara otomatis) dengan memasukkan nama project baru di langkah pertama alur kerja "Create project".
Opsi 2: "Tambahkan Firebase" ke project Google Cloud yang ada dengan memilih nama project Google Cloud dari menu drop-down di langkah pertama alur kerja "Create project".
Perhatikan bahwa saat diminta, Anda tidak perlu menyiapkan Google Analytics untuk menggunakan SDK Vertex AI in Firebase.
Di Firebase console, buka halaman Build with Gemini.
Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas berikut:
Mengupgrade project Anda untuk menggunakan paket harga Blaze bayar sesuai penggunaan.
Aktifkan API yang diperlukan di project Anda (Vertex AI API dan Vertex AI in Firebase API).
Menghubungkan aplikasi ke Firebase
Lanjutkan di alur kerja AI generatif konsol untuk menghubungkan aplikasi Anda ke Firebase, yang mencakup tugas-tugas berikut:
Mendaftarkan aplikasi ke project Firebase.
Menambahkan file konfigurasi Firebase (
google-services.jsongoogle-services
Pada langkah berikutnya dalam panduan ini, Anda akan menambahkan Vertex AI in Firebase SDK ke aplikasi dan menyelesaikan inisialisasi yang diperlukan khusus untuk menggunakan SDK dan Gemini API.
Langkah 2: Tambahkan SDK
Setelah project Firebase disiapkan dan aplikasi terhubung ke Firebase (lihat langkah sebelumnya), Anda kini dapat menambahkan SDK Vertex AI in Firebase ke aplikasi.
Vertex AI in Firebase SDK untuk Android (firebase-vertexai) menyediakan
akses ke API untuk berinteraksi dengan
model Gemini dan Imagen.
Dalam file Gradle modul (level aplikasi) (seperti <project>/<app-module>/build.gradle.kts), tambahkan dependensi untuk library Vertex AI in Firebase 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:33.10.0")) // Add the dependency for the Vertex AI in Firebase library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-vertexai") }
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:33.10.0")) // Add the dependency for the Vertex AI in Firebase library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-vertexai") // 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.
(Alternatif) Tambahkan dependensi library Firebase tanpa menggunakan BoM
Jika memilih untuk tidak menggunakan Firebase BoM, Anda harus menentukan setiap versi library Firebase di baris dependensinya.
Perlu diperhatikan bahwa jika Anda menggunakan beberapa library Firebase di aplikasi, sebaiknya gunakan BoM untuk mengelola versi library, yang memastikan bahwa semua versi kompatibel.
dependencies { // Add the dependency for the Vertex AI in Firebase library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-vertexai:16.2.0") }
Langkah 3: Lakukan inisialisasi layanan Vertex AI dan model generatif
Sebelum dapat melakukan panggilan API dan meminta model Gemini, Anda harus melakukan inisialisasi layanan Vertex AI dan model generatif.
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
val generativeModel = Firebase.vertexAI.generativeModel("gemini-2.0-flash")
Publisher dari library Reactive Streams.
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
GenerativeModel gm = FirebaseVertexAI.getInstance()
.generativeModel("gemini-2.0-flash");
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
Setelah menyelesaikan panduan memulai ini, pelajari cara memilih model dan (opsional) lokasi yang sesuai untuk kasus penggunaan dan aplikasi Anda.
Langkah 4: Kirim permintaan perintah ke model
Setelah menghubungkan aplikasi ke Firebase, menambahkan SDK, dan melakukan inisialisasi layanan Vertex AI dan model generatif, Anda siap mengirim permintaan perintah ke model Gemini.
Anda dapat menggunakan generateContent() untuk membuat teks dari permintaan prompt
khusus teks:
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
val generativeModel = Firebase.vertexAI.generativeModel("gemini-2.0-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 = generativeModel.generateContent(prompt)
print(response.text)
ListenableFuture.
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
GenerativeModel gm = FirebaseVertexAI.getInstance()
.generativeModel("gemini-2.0-flash");
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
// 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);
Kamu bisa apa lagi?
Pelajari lebih lanjut model yang didukung
Pelajari model yang tersedia untuk berbagai kasus penggunaan serta kuota dan harga-nya.
Mencoba kemampuan lain Gemini API
- Pelajari lebih lanjut cara membuat teks dari perintah teks saja, termasuk cara menstreaming respons.
- Buat teks dari perintah multimodal (termasuk teks, gambar, PDF, video, dan audio).
- Buat percakapan multi-giliran (chat).
- Buat output terstruktur (seperti JSON) dari prompt teks dan multimodal.
- Gunakan panggilan fungsi untuk menghubungkan model generatif ke sistem dan informasi eksternal.
Pelajari cara mengontrol pembuatan konten
- Memahami desain perintah, termasuk praktik terbaik, strategi, dan contoh perintah.
- Mengonfigurasi parameter model seperti suhu dan token output maksimum (untuk Gemini) atau rasio aspek dan pembuatan orang (untuk Imagen).
- Gunakan setelan keamanan untuk menyesuaikan kemungkinan mendapatkan respons yang mungkin dianggap berbahaya.
Berikan masukan tentang pengalaman Anda dengan Vertex AI in Firebase