FAQ dan pemecahan masalah

Mengapa nama berubah dari "Vertex AI in Firebase" menjadi "Firebase AI Logic"?

Pada tahun 2024, kami meluncurkan serangkaian Firebase client SDK yang dapat menggunakan Vertex AI Gemini API serta gateway proxy Firebase untuk melindungi API tersebut dari penyalahgunaan dan untuk mengaktifkan integrasi dengan produk Firebase lainnya. Kami menyebut produk kami "Vertex AI in Firebase", dan nama produk ini secara akurat menggambarkan kasus penggunaan produk kami yang tersedia pada saat itu.

Namun, sejak saat itu, kami telah memperluas kemampuan produk kami. Misalnya, mulai Mei 2025, kami kini menawarkan dukungan untuk Gemini Developer API, termasuk kemampuan untuk melindungi Gemini Developer API dari penyalahgunaan menggunakan integrasi kami dengan Firebase App Check.

Akibatnya, nama "Vertex AI in Firebase" tidak lagi secara akurat merepresentasikan cakupan produk kami yang diperluas. Oleh karena itu, nama baru — Firebase AI Logic — lebih mencerminkan rangkaian fitur kami yang terus berkembang dan memungkinkan kami untuk terus memperluas penawaran kami di masa mendatang.

Lihat panduan migrasi untuk memastikan Anda mendapatkan semua fitur terbaru dari Firebase AI Logic (dan opsional mulai menggunakan Gemini Developer API).

Apa perbedaan antara penggunaan Gemini Developer API dan Vertex AI Gemini API?

Berikut beberapa perbedaan antara kedua penyedia "Gemini API" tersebut secara umum, terlepas dari cara Anda mengaksesnya:

• Harga

  • Gemini Developer API menawarkan "paket gratis" beserta harga bayar sesuai penggunaan.

  • Vertex AI Gemini API jika digunakan dengan Firebase AI Logic selalu memerlukan paket harga Blaze bayar sesuai penggunaan.

  Perhatikan bahwa kedua penyedia API memiliki harga bayar sesuai penggunaan yang berbeda (pelajari lebih lanjut dalam dokumentasi masing-masing).

• Batas frekuensi (kuota)

  • Gemini Developer API memiliki batas kapasitas eksplisit.

  • Vertex AI Gemini API menggunakan "kuota bersama dinamis (DSQ)" yang dibagikan oleh semua orang yang menggunakan model tersebut di region tersebut. Anda juga dapat secara opsional menyiapkan throughput yang disediakan (PT).

• Menentukan lokasi untuk mengakses model

  • Hanya Vertex AI Gemini API yang memungkinkan Anda memilih lokasi tempat Anda mengakses model.

Tabel berikut mencantumkan ketersediaan fitur yang umum ditanyakan untuk dua penyedia "Gemini API". Tabel ini berlaku khususnya saat menggunakan SDK klien Firebase AI Logic.

¹ Files API untuk Gemini Developer API tidak didukung melalui SDK Firebase AI Logic.

Dapatkah saya menggunakan Gemini Developer API dan Vertex AI Gemini API?

Ya, Anda dapat mengaktifkan kedua penyedia "Gemini API" di project Firebase Anda, dan Anda dapat menggunakan kedua API tersebut di aplikasi Anda.

Untuk beralih antar-penyedia API dalam kode Anda, cukup pastikan Anda telah menyetel layanan backend dengan tepat dalam kode Anda.

Apa saja API yang diperlukan? Bagaimana cara mengaktifkannya?

Untuk menggunakan SDK Firebase AI Logic dengan Gemini Developer API, project Anda harus mengaktifkan dua API berikut:

• Gemini Developer API (generativelanguage.googleapis.com)
• Firebase AI Logic API (firebasevertexai.googleapis.com)

Anda harus mengaktifkan kedua API ini menggunakan konsol Firebase:

1. Di konsol Firebase, buka halaman Firebase AI Logic.

2. Klik Get started.

3. Pilih untuk mulai menggunakan Gemini Developer API.

   Tindakan ini akan meluncurkan alur kerja terpandu yang mengaktifkan kedua API untuk Anda. Konsol juga akan membuat kunci API Gemini, serta menambahkan API Firebase AI Logic ke daftar yang diizinkan untuk kunci API Firebase Anda.

Model mana yang dapat digunakan dengan SDK Firebase AI Logic?

Lihat daftar model yang didukung di Pelajari model yang didukung. Kami sering menambahkan kemampuan baru ke SDK, jadi periksa kembali FAQ ini untuk melihat update (serta di catatan rilis, blog, dan postingan media sosial).

Gemini Developer API

Anda dapat menggunakan model dasar Gemini dan Imagen.

Perhatikan bahwa Gemini Developer API (terlepas dari cara mengaksesnya) hanya mendukung pembuatan gambar oleh model imagen-3.0-fast-generate-002.

Vertex AI Gemini API

Anda dapat menggunakan model dasar Gemini dan Imagen.

Terlepas dari penyedia Gemini API yang Anda pilih

Firebase AI Logic tidak mendukung hal berikut:

• Model Gemininon-dasar (seperti model PaLM, model yang disesuaikan, atau model berbasis Gemma).

• Model Imagen lama atau imagen-3.0-capability-001.

Apa yang harus dilakukan saat model dihentikan?

Saat merilis versi model stabil, kami berupaya memastikan bahwa versi tersebut tersedia selama setidaknya satu tahun. Kami mencantumkan "tanggal penghentian" ini di beberapa tempat di dokumentasi Firebase dan Google Cloud (misalnya, di halaman"Model").

Saat model dihentikan, setiap permintaan ke model tersebut akan gagal dengan error 404. Oleh karena itu, sebaiknya siapkan dan gunakan Firebase Remote Config agar Anda dapat mengubah model dan versi secara dinamis di aplikasi tanpa merilis versi baru aplikasi.

Saat Anda mengupdate aplikasi untuk menggunakan versi model baru, sebaiknya uji aplikasi Anda untuk memastikan respons masih sesuai yang diharapkan. Perhatikan bahwa saat menggunakan Firebase AI Logic, biasanya tidak ada modifikasi yang diperlukan untuk kode yang sebenarnya memanggil model.

Berikut adalah tanggal penghentian untuk berbagai model:

• Model Gemini 1.5 Pro:

  • gemini-1.5-pro-002 (dan gemini-1.5-pro): 24 September 2025
  • gemini-1.5-pro-001: 24 Mei 2025

• Model Gemini 1.5 Flash:

  • gemini-1.5-flash-002 (dan gemini-1.5-flash): 24 September 2025
  • gemini-1.5-flash-001: 24 Mei 2025

• Gemini 1.0 Pro Vision model: 21 April 2025 (sebelumnya dijadwalkan pada 9 April 2025)

• Gemini 1.0 Pro model: 21 April 2025 (sebelumnya dijadwalkan pada 9 April 2025)

Bagaimana cara menetapkan batas kapasitas per pengguna?

Secara default, Firebase AI Logic menetapkan batas permintaan per pengguna pada 100 permintaan per menit (RPM).

Jika ingin menyesuaikan batas kapasitas per pengguna, Anda perlu menyesuaikan setelan kuota untuk Firebase AI Logic API.

Pelajari lebih lanjut Firebase AI Logic kuota API. Di halaman tersebut, Anda juga dapat mempelajari cara melihat dan mengedit kuota.

Izin mana yang diperlukan untuk menggunakan SDK Firebase AI Logic?

Apakah Firebase AI Logic menggunakan data saya untuk melatih model?

Lihat Tata kelola data & Responsible AI.

Apakah jenis MIME diperlukan dalam permintaan multimodal saya? (seperti untuk input gambar, PDF, video, dan audio)

Ya, dalam setiap permintaan multimodal, Anda harus selalu memberikan hal berikut:

• mimeType file. Lihat pengecualian di bawah.

• File. Anda dapat memberikan file sebagai data inline atau memberikan file menggunakan URL-nya.

Pelajari jenis file input yang didukung, cara menentukan jenis MIME, dan dua opsi untuk menyediakan file di File input yang didukung dan persyaratan.

Pengecualian untuk menyertakan jenis MIME dalam permintaan Anda

Pengecualian untuk memberikan jenis MIME adalah input gambar inline untuk permintaan dari aplikasi platform Android dan Apple native.

SDK Firebase AI Logic untuk platform Android dan Apple menyediakan cara yang disederhanakan dan kompatibel dengan platform untuk menangani gambar dalam permintaan — semua gambar (apa pun formatnya) dikonversi di sisi klien ke JPEG dengan kualitas 80% sebelum dikirim ke server. Artinya, saat Anda memberikan gambar sebagai data inline menggunakan SDK platform Android dan Apple, Anda tidak perlu menentukan jenis MIME dalam permintaan.

Penanganan yang disederhanakan ini ditampilkan dalam dokumentasi Firebase AI Logic di contoh untuk mengirim gambar berenkode base64 dalam permintaan.

Berikut beberapa informasi tambahan khusus platform tentang fitur ini:

• Untuk Android:

  • Anda dapat memanfaatkan cara yang disederhanakan untuk menangani jenis gambar platform-native (Bitmap) dalam perintah multimodal yang berisi gambar sebagai data inline (lihat contoh).

  • Untuk kontrol yang lebih besar atas format dan konversi gambar, Anda dapat memberikan gambar sebagai InlineDataPart dan memberikan jenis MIME tertentu. Contoh:

    content { inlineData(/* PNG as byte array */, "image/png") }

• Untuk platform Apple:

  • Anda dapat memanfaatkan cara yang lebih sederhana untuk menangani jenis gambar bawaan platform (UIImage, NSImage, CIImage, dan CGImage) dalam perintah multimodal yang berisi gambar sebagai data inline (lihat contoh).

  • Untuk kontrol yang lebih besar atas format dan konversi gambar, Anda dapat memberikan gambar sebagai InlineDataPart dan memberikan jenis MIME tertentu. Contoh:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

Apakah fitur ini tersedia saat menggunakan Firebase AI Logic? Penembolokan konteks, Penelusuran sebagai alat, perujukan dengan Google Penelusuran, eksekusi kode, penyesuaian model, pembuatan embedding, dan pengambilan semantik?

Penyimpanan cache konteks, Penelusuran sebagai alat, perujukan dengan Google Penelusuran, eksekusi kode, penyesuaian model, pembuatan sematan, dan pengambilan semantik didukung oleh berbagai model atau Vertex AI Gemini API, tetapi fitur tersebut tidak tersedia saat menggunakan Firebase AI Logic.

Jika Anda ingin menambahkan permintaan ini sebagai permintaan fitur atau memberikan suara pada permintaan fitur yang ada, buka Firebase UserVoice.

Apa yang dimaksud dengan kunci API Gemini?

Gemini Developer API menggunakan "kunci API Gemini" untuk mengotorisasi pemanggil. Jadi, jika Anda menggunakan Gemini Developer API melalui SDK Firebase AI Logic, Anda memerlukan kunci API Gemini yang valid di project Firebase untuk melakukan panggilan ke API tersebut.

"Kunci API Gemini" hanya berarti kunci API yang memiliki Gemini Developer API dalam daftar yang diizinkan API-nya.

Saat Anda menyelesaikan alur kerja penyiapan Firebase AI Logic di konsol Firebase, kami akan membuat kunci API Gemini yang dibatasi hanya untuk Gemini Developer API, dan kami akan menyiapkan layanan proxy Firebase AI Logic untuk menggunakan kunci API ini. Kunci API Gemini yang dibuat Firebase ini diberi nama Gemini Developer API key (auto created by Firebase) di halaman kredensial konsol Google Cloud.

Pelajari lebih lanjut pembatasan API untuk kunci API.

Anda tidak menambahkan kunci API Gemini ke codebase aplikasi saat menggunakan SDK Firebase AI Logic. Pelajari lebih lanjut cara menjaga keamanan kunci API Gemini Anda.

Haruskah saya menambahkan kunci API Gemini ke codebase aplikasi seluler atau web saya?

Saat menggunakan SDK Firebase AI Logic, jangan tambahkan kunci API Gemini ke codebase aplikasi Anda.

Faktanya, saat mengembangkan dengan SDK Firebase AI Logic, Anda tidak berinteraksi langsung dengan kunci API Gemini. Sebagai gantinya, layanan proxy Firebase AI Logic kami akan menyertakan kunci API Gemini secara internal di setiap permintaan ke Gemini Developer API — sepenuhnya di backend.

Bagaimana cara mengubah kunci API Gemini yang digunakan untuk memanggil Gemini Developer API?

Saat menggunakan SDK Firebase AI Logic, Anda kemungkinan tidak perlu mengubah kunci API Gemini. Namun, berikut dua kasus yang mungkin mengharuskan Anda melakukannya:

• Jika Anda tidak sengaja membocorkan kunci dan ingin menggantinya dengan kunci baru yang aman.

• Jika Anda tidak sengaja menghapus kunci. Perhatikan bahwa Anda dapat membatalkan penghapusan kunci dalam waktu 30 hari setelah penghapusan.

Berikut cara mengubah kunci API Gemini yang digunakan oleh SDK Firebase AI Logic:

1. Jika kunci API Gemini yang dibuat Firebase masih ada, hapus.

   Anda dapat menghapus kunci API ini di panel APIs & Services > Credentials di Google Cloud console. Kunci tersebut diberi nama:
   Kunci Gemini Developer API (dibuat otomatis oleh Firebase).

2. Di halaman yang sama di konsol Google Cloud, buat kunci API baru. Sebaiknya beri nama seperti:
   Kunci Gemini Developer API untuk Firebase.

3. Untuk kunci API baru ini, tambahkan pembatasan API dan pilih Generative Language API saja.
   "Generative Language API" adalah nama lain dari Gemini Developer API di konsol Google Cloud.

   Jangan menambahkan pembatasan aplikasi; jika tidak, layanan proxy Firebase AI Logic tidak akan berfungsi seperti yang diharapkan.

4. Jalankan perintah berikut untuk menetapkan kunci baru ini sebagai kunci API Gemini yang harus digunakan oleh layanan proxy Firebase AI Logic.

   PROJECT_ID="PROJECT_ID"
   GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY"
   curl \
     -X PATCH \
     -H "x-goog-user-project: ${PROJECT_ID}" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \
     -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
   

   Pelajari gcloud CLI.

Pastikan untuk tidak menambahkan kunci API Gemini baru ini ke codebase aplikasi Anda. Pelajari lebih lanjut cara menjaga keamanan kunci API Gemini Anda.

Dapatkah saya menggunakan "kunci API Firebase" sebagai kunci API Gemini saya?

Tidak — Anda tidak boleh menggunakan "kunci API Firebase" sebagai kunci API Gemini Anda. Sebaiknya jangan tambahkan Gemini Developer API ke daftar yang diizinkan untuk kunci Firebase API Anda.

Kunci API Firebase Anda adalah kunci API yang tercantum dalam file atau objek konfigurasi Firebase yang Anda tambahkan ke codebase aplikasi untuk menghubungkan aplikasi Anda ke Firebase. Anda boleh menyertakan kunci API Firebase dalam kode jika hanya menggunakan kunci tersebut dengan API terkait Firebase (seperti Firebase AI Logic). Pelajari informasi penting tentang kunci API Firebase.

Di panel APIs & Services > Credentials di Google Cloud console, inilah tampilan kunci API Firebase:

Karena Anda perlu menambahkan kunci Firebase API ke codebase aplikasi agar API terkait Firebase berfungsi, dan karena Gemini Developer API diizinkan melalui kunci API, sebaiknya JANGAN menambahkan Gemini Developer API (disebut "Generative Language API" di konsol Google Cloud) ke daftar yang diizinkan API untuk kunci Firebase API Anda. Jika Anda melakukannya, Anda akan mengekspos Gemini Developer API ke potensi penyalahgunaan.

Bagaimana cara menjaga keamanan kunci API Gemini saya?

FAQ ini menjelaskan beberapa praktik terbaik yang direkomendasikan untuk menjaga keamanan kunci API Gemini Anda.

Jika Anda memanggil Gemini Developer API langsung dari aplikasi seluler atau web:

• Gunakan SDK klien Firebase AI Logic.
• Jangan menambahkan kunci API Gemini ke codebase aplikasi Anda.

Firebase AI Logic menyediakan layanan proxy yang secara internal menyertakan kunci API Gemini Anda dalam setiap permintaan ke Gemini Developer API — sepenuhnya di backend.

Selain itu, sebaiknya lakukan tindakan berikut:

• Segera setelah Anda mulai mengembangkan aplikasi secara serius, lakukan integrasi dengan Firebase App Check untuk membantu melindungi resource backend Anda serta API yang digunakan untuk mengakses model generatif.

• Jangan menggunakan kembali kunci API Gemini yang dibuat Firebase di luar Firebase AI Logic. Jika Anda memerlukan kunci API Gemini untuk kasus penggunaan lain, buat kunci terpisah.

• Secara umum, Anda TIDAK boleh mengubah kunci API Gemini yang dibuat Firebase. Kunci ini diberi nama Gemini Developer API key (auto created by Firebase) di konsol Google Cloud.

  • Jangan menambahkan API lain ke daftar yang diizinkan API untuk kunci API Gemini yang dibuat Firebase. Dalam daftar yang diizinkan API-nya, kunci API Gemini Anda hanya boleh memiliki Gemini Developer API (disebut "Generative Language API" di konsol Google Cloud).

  • Jangan menambahkan pembatasan aplikasi; jika tidak, layanan proxy Firebase AI Logic tidak akan berfungsi seperti yang diharapkan.

Kunci API Gemini saya disusupi. Apa yang harus saya lakukan?

Jika kunci API Gemini Anda telah disusupi, ikuti petunjuk untuk mengubah kunci API Gemini yang digunakan untuk memanggil Gemini Developer API.

Selain itu, tinjau praktik terbaik yang direkomendasikan untuk menjaga keamanan kunci API Gemini Anda.

Bagaimana cara memperbaiki error 404 ini? Firebase AI Logic genai config not found

Jika Anda mencoba menggunakan Gemini Developer API dan menerima error 404 yang menyatakan Firebase AI Logic genai config not found, biasanya berarti project Firebase Anda tidak memiliki kunci API Gemini yang valid untuk digunakan dengan SDK klien Firebase AI Logic.

Berikut adalah kemungkinan penyebab error ini:

• Anda belum menyiapkan project Firebase untuk Gemini Developer API.

  Yang harus dilakukan:
  Di Firebase console, buka halaman Firebase AI Logic. Klik Mulai, lalu pilih Gemini Developer API. Aktifkan API, dan konsol akan menyiapkan project Anda untuk Gemini Developer API. Setelah menyelesaikan alur kerja, coba permintaan Anda lagi.

• Jika Anda baru saja menyelesaikan alur kerja penyiapan Firebase AI Logic di konsol Firebase, kunci API Gemini Anda mungkin belum tersedia untuk semua layanan backend yang diperlukan di semua region.

  Yang harus dilakukan:
  Tunggu beberapa menit, lalu coba permintaan Anda lagi.

• Kunci API Gemini Anda mungkin telah dihapus dari project Firebase Anda.

  Yang harus dilakukan:
  Pelajari cara mengubah kunci API Gemini yang digunakan oleh Firebase AI Logic.

Bagaimana cara memperbaiki error 400 ini? Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Jika Anda mencoba mengirim permintaan multimodal dengan URL Cloud Storage for Firebase, Anda mungkin mengalami error 400 berikut:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Error ini disebabkan oleh project yang tidak memiliki agen layanan yang diperlukan yang disediakan secara otomatis dengan benar saat Vertex AI API diaktifkan di project. Ini adalah masalah umum pada beberapa project, dan kami sedang berupaya melakukan perbaikan global.

Berikut solusi untuk memperbaiki project Anda dan menyediakan agen layanan ini dengan benar sehingga Anda dapat mulai menyertakan URL Cloud Storage for Firebase dalam permintaan multimodal Anda. Anda harus menjadi Pemilik project, dan Anda hanya perlu menyelesaikan serangkaian tugas ini satu kali untuk project Anda.

1. Akses dan autentikasi dengan gcloud CLI.
   Cara termudah untuk melakukannya adalah dari Cloud Shell. Pelajari lebih lanjut di dokumentasi Google Cloud.

2. Jika diminta, ikuti petunjuk yang ditampilkan di terminal untuk membuat gcloud CLI berjalan terhadap project Firebase Anda.

   Anda memerlukan project ID Firebase, yang dapat ditemukan di bagian atas settings Setelan project di konsol Firebase.

3. Sediakan agen layanan yang diperlukan di project Anda dengan menjalankan perintah berikut:

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
   

4. Tunggu beberapa menit untuk memastikan agen layanan disediakan, lalu coba lagi mengirim permintaan multimodal Anda yang menyertakan URL Cloud Storage for Firebase.

Jika Anda masih mendapatkan error ini setelah menunggu beberapa menit, hubungi Dukungan Firebase.

Bagaimana cara memperbaiki error 400 ini? API key not valid. Please pass a valid API key.

Jika Anda menerima error 400 yang menyatakan API key not valid. Please pass a valid API key., biasanya berarti kunci API di file/objek konfigurasi Firebase Anda tidak ada atau tidak disiapkan untuk digunakan dengan aplikasi dan/atau project Firebase Anda.

Periksa apakah kunci API yang tercantum dalam file/objek konfigurasi Firebase Anda cocok dengan kunci API untuk aplikasi Anda. Anda dapat melihat semua kunci API di panel APIs & Services > Credentials di Google Cloud console.

Jika Anda menemukan bahwa keduanya tidak cocok, dapatkan file/objek konfigurasi Firebase baru, lalu ganti file/objek yang ada di aplikasi Anda. File/objek konfigurasi baru harus berisi kunci API yang valid untuk aplikasi dan project Firebase Anda.

Bagaimana cara memperbaiki error 403 ini? Requests to this API firebasevertexai.googleapis.com ... are blocked.

Jika Anda menerima error 403 yang menyatakan Requests to this API firebasevertexai.googleapis.com ... are blocked., biasanya berarti kunci API dalam file/objek konfigurasi Firebase Anda tidak memiliki API yang diperlukan dalam daftar yang diizinkannya untuk produk yang sedang Anda coba gunakan.

Pastikan kunci API yang digunakan oleh aplikasi Anda memiliki semua API yang diperlukan yang disertakan dalam daftar yang diizinkan "pembatasan API" kunci. Untuk Firebase AI Logic, kunci API Anda minimal harus memiliki Firebase AI Logic API dalam daftar yang diizinkannya.

Anda dapat melihat semua kunci API di panel APIs & Services > Credentials di Google Cloud console.

Bagaimana cara memperbaiki error 403 ini? PERMISSION_DENIED: The caller does not have permission.

Jika Anda menerima error 403 yang menyatakan PERMISSION_DENIED: The caller does not have permission., biasanya berarti kunci API di file/objek konfigurasi Firebase Anda termasuk dalam project Firebase yang berbeda.

Periksa apakah kunci API yang tercantum dalam file/objek konfigurasi Firebase Anda cocok dengan kunci API untuk aplikasi Anda. Anda dapat melihat semua kunci API di panel APIs & Services > Credentials di Google Cloud console.

Jika Anda menemukan bahwa keduanya tidak cocok, dapatkan file/objek konfigurasi Firebase baru, lalu ganti file/objek yang ada di aplikasi Anda. File/objek konfigurasi baru harus berisi kunci API yang valid untuk aplikasi dan project Firebase Anda.