Mulai menggunakan Gemini API menggunakan Vertex AI for Firebase SDK

iOS+ Android Web Flutter

Pratinjau: Vertex AI for Firebase masih dalam versi Pratinjau. Artinya, produk ini tidak tunduk pada SLA atau kebijakan penghentian layanan dan dapat berubah dengan cara yang tidak kompatibel dengan versi sebelumnya.

Panduan ini menunjukkan cara untuk mulai melakukan panggilan ke Vertex AI Gemini API langsung dari aplikasi Anda menggunakan Vertex AI for Firebase SDK.

Opsi lain untuk menggunakan Gemini API

• Anda dapat secara opsional memanggil Vertex AI Gemini API sisi server menggunakan Vertex AI SDK sisi server atau Firebase Extensions untuk Gemini API.

• Anda dapat secara opsional mencoba versi "AI Google" alternatif dari Gemini API yang menyediakan akses tanpa biaya (selama batas dan jika tersedia) menggunakan Google AI Studio dan Google AI SDK.

  Jika Anda memilih untuk menggunakan alat dan layanan AI Google serta Firebase, sebaiknya gunakan hal berikut:

  • Jangan gunakan Google AI Studio dan Google AI SDK dengan project Firebase yang digunakan oleh aplikasi produksi Anda.
  • Setelah Anda memahami cara kerja Gemini API, lakukan migrasi ke Vertex AI for Firebase SDK yang memiliki banyak fitur tambahan yang penting untuk aplikasi seluler dan web, seperti melindungi API dari penyalahgunaan menggunakan Firebase App Check.

Prasyarat

Panduan ini mengasumsikan bahwa Anda sudah memahami penggunaan Xcode dalam mengembangkan aplikasi untuk platform Apple (seperti iOS).

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

  • Xcode 15.0 atau yang lebih tinggi
  • Aplikasi Anda harus menargetkan iOS 15 atau yang lebih baru, atau macOS 12 atau yang lebih baru.

• (Opsional) Lihat aplikasi contoh.

  Download aplikasi contoh

  Anda dapat mencoba SDK dengan cepat, melihat implementasi lengkap dari berbagai kasus penggunaan, atau menggunakan aplikasi contoh jika tidak memiliki aplikasi platform Apple sendiri. Untuk menggunakan aplikasi contoh ini, 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

1. 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 dan firebaseml.googleapis.com.

2. 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

1. Login ke Firebase console.

2. 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 "Buat project".

   • Opsi 2: "Tambahkan Firebase" ke project Google Cloud yang ada dengan memilih nama project Google Cloud Anda dari menu drop-down pada langkah pertama alur kerja "Buat project".

   Perhatikan bahwa saat diminta, Anda tidak perlu menyiapkan Google Analytics untuk menggunakan Vertex AI for Firebase SDK.

3. 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 dan firebaseml.googleapis.com.

Menghubungkan aplikasi ke Firebase

1. Lanjutkan di alur kerja AI generatif konsol untuk menghubungkan aplikasi Anda ke Firebase, yang mencakup tugas berikut:

   • Mendaftarkan aplikasi ke project Firebase.

   • Menambahkan file konfigurasi Firebase (GoogleService-Info.plist) ke aplikasi Anda.

2. Pada langkah berikutnya dalam panduan ini, Anda akan menambahkan Vertex AI for Firebase SDK ke aplikasi dan menyelesaikan inisialisasi yang diperlukan khusus untuk menggunakan SDK dan Gemini API.

Catatan: Jika tidak menggunakan alur kerja AI generatif konsol, Anda juga dapat meluncurkan alur kerja penyiapan aplikasi dari bagian tengah halaman ringkasan project di konsol dengan mengklik ikon iOS+ atau Tambahkan aplikasi.

Catatan: Di Firebase console, sebaiknya siapkan Firebase App Check. Jika hanya mencoba Gemini API, Anda tidak perlu langsung menyiapkan App Check. Namun, sebaiknya siapkan App Check begitu Anda mulai mengembangkan aplikasi dengan serius.

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.

iOS+ Android Web Flutter

Library Vertex AI for Firebase menyediakan akses ke Vertex AI Gemini API dan disertakan sebagai bagian dari Firebase SDK untuk platform Apple (firebase-ios-sdk). Untuk library Vertex AI for Firebase, Anda harus menggunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase. Pengelola paket lain, seperti CocoaPods, saat ini tidak didukung.

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

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

     https://github.com/firebase/firebase-ios-sdk
   

3. Pilih versi SDK terbaru.

4. Pilih library FirebaseVertexAI-Preview.

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

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.

1. Impor modul FirebaseVertexAI:

   import FirebaseVertexAI
   

2. Lakukan inisialisasi layanan Vertex AI dan model generatif:

   import FirebaseVertexAI
   
   // Initialize the Vertex AI service
   let vertex = VertexAI.vertexAI()
   
   // Initialize the generative model with a model that supports your use case
   // Gemini 1.5 models are versatile and can be used with all API capabilities
   let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")
   

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 FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")

// 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)
if let text = response.text {
  print(text)
}

Gemini API juga dapat melakukan streaming respons untuk interaksi yang lebih cepat, serta menangani perintah multimodal yang mencakup konten seperti gambar, video, dan audio. Lihat semua kemampuan Gemini API nanti di halaman ini.

Jika terjadi error, pastikan project Firebase Anda disiapkan dengan benar menggunakan paket harga Blaze dan API yang diperlukan telah diaktifkan. Untuk mengaktifkan logging tambahan, tambahkan -GoogleGenerativeAIDebugLogEnabled sebagai argumen peluncuran di Xcode.

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.

Anda juga dapat bereksperimen dengan prompt dan konfigurasi model menggunakan Vertex AI Studio.

Memberikan masukan tentang pengalaman Anda menggunakan Vertex AI for Firebase