FAQ dan pemecahan masalah

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Pada tahun 2024, kami meluncurkan serangkaian SDK klien Firebase yang dapat menggunakan Vertex AI Gemini API serta gateway proxy Firebase untuk melindungi API tersebut dari penyalahgunaan dan mengaktifkan integrasi dengan produk Firebase lainnya. Kami menyebut produk kami "Vertex AI di Firebase", dan nama produk ini secara akurat menjelaskan 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 di Firebase" tidak lagi mewakili cakupan produk kami yang diperluas secara akurat. Oleh karena itu, nama baru — Firebase AI Logic — lebih mencerminkan kumpulan 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 secara 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" secara umum, terlepas dari cara Anda mengaksesnya:

• Harga

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

  • Vertex AI Gemini API saat 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 kapasitas (kuota)

  • Gemini Developer API memiliki batas kapasitas eksplisit.

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

• 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 sering ditanyakan untuk kedua penyedia "Gemini API". Tabel ini berlaku khusus 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, dan Anda dapat menggunakan kedua API tersebut di aplikasi itu sendiri.

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

Apa API yang diperlukan? Dan bagaimana cara mengaktifkannya?

Untuk menggunakan Firebase AI Logic SDK 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 Firebase console, buka halaman Firebase AI Logic.

2. Klik Get started.

3. Pilih untuk memulai 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 Firebase API Anda.

Model mana yang dapat digunakan dengan SDK Firebase AI Logic?

• Anda dapat menggunakan model fondasi Gemini dan Imagen 3 apa pun dengan Firebase AI Logic SDK, termasuk versi pratinjau dan eksperimental. Lihat daftar model ini di Pelajari model yang didukung.

• Anda tidak dapat menggunakan model Gemini non-fondasi (seperti model PaLM, model yang dioptimalkan, atau model berbasis Gemma) dengan Firebase AI Logic SDK.

  Firebase AI Logic juga tidak mendukung model Imagen atau imagen-3.0-capability-001 lama.

• Gemini Developer API (terlepas dari cara diaksesnya) tidak mendukung imagen-3.0-fast-generate-001 atau imagen-3.0-generate-001 yang lebih lama.

Kami sering menambahkan kemampuan baru ke SDK, jadi periksa kembali FAQ ini untuk mengetahui update (serta dalam catatan rilis, blog, dan postingan media sosial).

Apa yang harus dilakukan saat model dihentikan?

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

Jika 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 untuk memastikan respons masih seperti yang diharapkan. Perhatikan bahwa saat menggunakan Firebase AI Logic, biasanya tidak ada modifikasi yang diperlukan untuk kode apa pun yang benar-benar 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

• Model Gemini 1.0 Pro Vision: 21 April 2025 (sebelumnya dijadwalkan pada 09 April 2025)

• Model Gemini 1.0 Pro: 21 April 2025 (sebelumnya dijadwalkan pada 09 April 2025)

Bagaimana cara menetapkan batas kapasitas per pengguna?

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

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

Pelajari lebih lanjut kuota API Firebase AI Logic. 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 Persyaratan dan file input yang didukung.

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 mudah digunakan untuk menangani gambar dalam permintaan — semua gambar (apa pun formatnya) dikonversi sisi klien ke JPEG dengan kualitas 80% sebelum dikirim ke server. Artinya, saat 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 dalam 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 native platform (Bitmap) dalam perintah multimodal yang berisi gambar sebagai data inline (lihat contoh).

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

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

• Untuk platform Apple:

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

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

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

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

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

Jika Anda ingin menambahkannya 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 memberikan otorisasi ke pemanggil. Jadi, jika Anda menggunakan Gemini Developer API melalui Firebase AI Logic SDK, 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 melakukan alur kerja penyiapan Firebase AI Logic di konsol Firebase, kami membuat kunci API Gemini yang hanya dibatasi untuk Gemini Developer API, dan kami menyiapkan layanan proxy Firebase AI Logic untuk menggunakan kunci API ini. Kunci API Gemini yang dibuat Firebase ini bernama Kunci API Developer Gemini (dibuat otomatis oleh 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.

Apakah saya harus 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.

Bahkan, 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 dalam 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 memerlukan:

• 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 kunci tersebut.

   Anda dapat menghapus kunci API ini di panel APIs & Services > Credentials di Google Cloud console. Kunci ini bernama:
   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 hanya pilih Generative Language API.
   "Generative Language API" adalah nama yang kadang-kadang digunakan untuk Gemini Developer API di konsol Google Cloud.

   Jangan tambahkan 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 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.

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

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

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

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

Karena Anda perlu menambahkan kunci Firebase API ke codebase aplikasi agar API terkait Firebase berfungsi, dan karena Gemini Developer API diotorisasi melalui kunci API, sebaiknya JANGAN tambahkan Gemini Developer API (disebut "Generative Language API" di konsol Google Cloud) ke daftar yang diizinkan API untuk kunci Firebase API Anda. Jika 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 tambahkan 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 hal berikut:

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

• Jangan gunakan 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 dihasilkan Firebase. Kunci ini bernama Kunci Gemini Developer API (dibuat otomatis oleh Firebase) di konsol Google Cloud.

  • Jangan tambahkan API tambahan ke daftar yang diizinkan API untuk kunci API Gemini yang dihasilkan 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 tambahkan 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 bertuliskan Firebase AI Logic genai config not found, biasanya hal ini berarti project Firebase Anda tidak memiliki kunci API Gemini yang valid untuk digunakan dengan SDK klien Firebase AI Logic.

Berikut 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 wilayah.

  Tindakan 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 memperbaikinya secara global.

Berikut adalah solusi untuk memperbaiki project dan menyediakan agen layanan ini dengan benar sehingga Anda dapat mulai menyertakan URL Cloud Storage for Firebase dalam permintaan multimodal. Anda harus menjadi Pemilik project, dan Anda hanya perlu menyelesaikan kumpulan 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 di 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 bahwa agen layanan telah disediakan, lalu coba kirim ulang 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 bertuliskan API key not valid. Please pass a valid API key., biasanya hal ini berarti kunci API di file/objek konfigurasi Firebase tidak ada atau tidak disiapkan untuk digunakan dengan aplikasi dan/atau project Firebase Anda.

Pastikan 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 mendapati 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 bertuliskan Requests to this API firebasevertexai.googleapis.com ... are blocked., biasanya hal ini berarti kunci API dalam file/objek konfigurasi Firebase Anda tidak memiliki API yang diperlukan dalam daftar yang diizinkan untuk produk yang 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 harus memiliki setidaknya Firebase AI Logic API dalam daftar yang diizinkan.

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 bertuliskan PERMISSION_DENIED: The caller does not have permission., biasanya hal ini berarti kunci API dalam file/objek konfigurasi Firebase Anda adalah milik project Firebase yang berbeda.

Pastikan 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 mendapati 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.