Mulai gunakan GeminiIAP API menggunakan Vertex akhir AI di SDK Firebase

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

Opsi lainnya 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.

Prasyarat

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 15.0 atau yang lebih baru
  • Aplikasi Anda harus menargetkan iOS 15 atau yang lebih tinggi, atau macOS 12 atau yang lebih tinggi.

• (Opsional) Lihat aplikasi contoh.

  Mendownload aplikasi contoh

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

1. Di Firebase console, buka halaman Build with Gemini.

2. Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas-tugas berikut:

   • Upgrade 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).

3. 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 "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.

3. Di Firebase console, buka halaman Build with Gemini.

4. Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas-tugas berikut:

   • Upgrade 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

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

   • Mendaftarkan aplikasi ke project Firebase Anda.

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

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

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

Library Vertex AI in Firebase memberikan akses ke Vertex AI Gemini API dan disertakan sebagai bagian dari Firebase SDK untuk platform Apple (firebase-ios-sdk).

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.

   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")
   

Setelah menyelesaikan panduan memulai, pelajari cara memilih model Gemini dan (opsional) lokasi yang sesuai untuk kasus penggunaan dan aplikasi Anda.

Langkah 4: Panggil Vertex AI Gemini API

Setelah menghubungkan aplikasi ke Firebase, menambahkan SDK, dan melakukan inisialisasi layanan Vertex AI dan model generatif, Anda siap memanggil Vertex AI Gemini API.

Anda dapat menggunakan generateContent() untuk membuat teks dari permintaan prompt khusus 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")

// 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.")

Kamu bisa apa lagi?

Pelajari model Gemini lebih lanjut

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 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.
• Konfigurasikan parameter model seperti temperatur dan token output maksimum.
• Gunakan setelan keamanan untuk menyesuaikan kemungkinan mendapatkan respons yang mungkin dianggap berbahaya.

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

Berikan masukan tentang pengalaman Anda dengan Vertex AI in Firebase