Panduan ini menunjukkan cara untuk mulai melakukan panggilan ke Vertex AI Gemini API langsung dari aplikasi Anda menggunakan Vertex AI for Firebase SDK.
Prasyarat
Panduan ini mengasumsikan bahwa Anda sudah terbiasa mengembangkan aplikasi dengan Flutter.
Pastikan lingkungan pengembangan dan aplikasi web Anda memenuhi persyaratan berikut:
- Dart 3.2.0+
(Opsional) Lihat aplikasi contoh.
Anda dapat mencoba SDK dengan cepat, melihat implementasi lengkap dari berbagai kasus penggunaan, atau menggunakan aplikasi contoh jika tidak memiliki aplikasi web Anda 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, lalu klik kartu kedua untuk meluncurkan alur kerja yang membantu Anda melakukan tugas-tugas berikut. Jika Anda melihat tab Vertex AI di konsol, berarti tugas-tugas ini sudah selesai.
Upgrade project Anda untuk menggunakan paket harga Blaze bayar sesuai penggunaan.
Aktifkan kedua API berikut untuk project Anda:
aiplatform.googleapis.com
danfirebaseml.googleapis.com
.
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 Anda terhubung ke Firebase (lihat langkah sebelumnya), Anda kini dapat menambahkan Vertex AI for Firebase SDK ke aplikasi.
Plugin Vertex AI for Firebase untuk Flutter (firebase_vertexai
) menyediakan akses ke Vertex AI Gemini API.
Dari direktori project Flutter Anda, jalankan perintah berikut untuk menginstal plugin inti:
flutter pub add firebase_core
Dalam file
lib/main.dart
, impor plugin inti Firebase dan file konfigurasi yang Anda buat sebelumnya:import 'package:firebase_core/firebase_core.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
Dari direktori project Flutter Anda, jalankan perintah berikut:
flutter pub add firebase_vertexai
Setelah selesai, bangun ulang project Flutter Anda:
flutter run
Langkah 3: Lakukan inisialisasi layanan Vertex AI dan model generatif
Sebelum dapat melakukan panggilan API, Anda perlu melakukan inisialisasi layanan Vertex AI dan model generatif.
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
// Initialize FirebaseApp
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');
Setelah menyelesaikan panduan memulai, pelajari cara memilih model Gemini dan (secara opsional) lokasi yang sesuai untuk kasus penggunaan dan aplikasi Anda.
Langkah 4: Panggil Vertex AI Gemini API
Setelah menghubungkan aplikasi ke Firebase, menambahkan SDK, serta melakukan inisialisasi layanan Vertex AI dan model generatif, Anda siap memanggil Vertex AI Gemini API.
Anda dapat menggunakan generateContent()
untuk membuat teks dari permintaan perintah
hanya teks:
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
await Firebase.initializeApp();
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.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);
Kamu bisa apa lagi?
Pelajari lebih lanjut model Gemini
Pelajari model yang tersedia untuk berbagai kasus penggunaan serta kuota dan harganya.
Mencoba kemampuan lain Gemini API
- Pelajari lebih lanjut cara membuat teks dari perintah khusus teks, termasuk cara menstreaming respons.
- Buat teks dari perintah multimodal (termasuk teks, gambar, PDF, video, dan audio).
- Membuat percakapan multi-giliran (chat).
- Gunakan panggilan fungsi untuk menghubungkan model generatif ke sistem dan informasi eksternal.
Pelajari cara mengontrol pembuatan konten
- Pahami desain prompt, termasuk praktik terbaik, strategi, dan contoh perintah.
- Konfigurasikan parameter model seperti token suhu dan output maksimum.
- Gunakan setelan keamanan untuk menyesuaikan kemungkinan mendapatkan respons yang mungkin dianggap berbahaya.
Memberikan masukan tentang pengalaman Anda menggunakan Vertex AI for Firebase