Mulai Menggunakan Gemini API menggunakan Vertex AI di Firebase SDK


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

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 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 penggunaan kasus, 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 konsol Firebase, buka Halaman Membuat aplikasi dengan Gemini.

  2. Klik kartu Vertex AI in Firebase untuk meluncurkan alur kerja yang membantu Anda menyelesaikan tugas-tugas berikut. (Perhatikan bahwa jika Anda melihat tab di konsol untuk Vertex AI, maka tugas ini selesai.)

  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


Langkah 2: Tambahkan SDK

Setelah project Firebase disiapkan dan aplikasi Anda telah terhubung ke Firebase (lihat langkah sebelumnya), Anda kini dapat menambahkan Vertex AI in Firebase SDK ke aplikasi.

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). Untuk library Vertex AI in Firebase, Anda harus menggunakan Swift Package Manager untuk menginstal dan mengelola Firebase dependensi. Pengelola paket lainnya, 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 Vertex AI model generatif dan 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 (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, dan melakukan inisialisasi layanan Vertex AI dan model generatif, Anda siap untuk memanggil Vertex AI Gemini API.

Anda dapat menggunakan generateContent() untuk membuat teks dari perintah hanya teks permintaan:

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

Kamu bisa apa lagi?

Pelajari lebih lanjut model Gemini

Pelajari tentang model yang tersedia untuk berbagai kasus penggunaan dan mereka kuota dan harga.

Coba kemampuan Gemini API lainnya

Pelajari cara mengontrol pembuatan konten

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


Beri masukan tentang pengalaman Anda dengan Vertex AI in Firebase