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.
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 mengembangkan aplikasi dengan Flutter.
Pastikan lingkungan pengembangan dan aplikasi Flutter Anda memenuhi persyaratan berikut:
- Dart 3.2.0+
(Opsional) Lihat aplikasi contoh.
Anda dapat mencoba SDK dengan cepat, melihat implementasi lengkap berbagai kasus penggunaan, atau menggunakan aplikasi contoh jika tidak memiliki aplikasi Flutter 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
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.
Plugin Vertex AI in Firebase untuk Flutter (firebase_vertexai
) menyediakan
akses ke API untuk berinteraksi dengan
model Gemini dan Imagen.
Dari direktori project Flutter Anda, jalankan perintah berikut untuk menginstal plugin inti dan plugin Vertex AI in Firebase:
flutter pub add firebase_core && flutter pub add firebase_vertexai
Dalam file
lib/main.dart
, impor plugin inti Firebase, plugin Vertex AI in Firebase, dan file konfigurasi yang Anda buat sebelumnya:import 'package:firebase_core/firebase_core.dart'; import 'package:firebase_vertexai/firebase_vertexai.dart'; import 'firebase_options.dart';
Selain itu, di file
lib/main.dart
, lakukan inisialisasi Firebase menggunakan objekDefaultFirebaseOptions
yang diekspor oleh file konfigurasi:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Build ulang aplikasi Flutter Anda:
flutter run
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.
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
// Initialize FirebaseApp
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');
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:
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-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);
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