Kode error

Error 400: 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 dalam file/objek konfigurasi Firebase Anda 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 APIs & Services > Credentials panel di konsol Google Cloud.

Jika Anda menemukan bahwa kunci API tersebut tidak cocok, maka 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.

Error 400: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Jika Anda mencoba mengirim permintaan multimodal dengan Cloud Storage for Firebase URL, Anda mungkin akan 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 otomatis disediakan dengan benar saat Agent Platform API diaktifkan di project. Ini adalah masalah umum pada beberapa project, dan kami sedang berupaya memperbaikinya secara global.

Berikut solusinya 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 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 dalam 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 Anda temukan di bagian atas setelan settings Project settings di Firebase console.

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, dan lalu coba kirim ulang permintaan multimodal yang menyertakan Cloud Storage for Firebase URL.

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

Error 403: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

Jika Anda menerima error 403 - PERMISSION_DENIED yang menyatakan To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, artinya permintaan Anda tidak memiliki token App Check yang valid dan Anda mencoba mengakses model yang biasanya disalahgunakan.

Beberapa model generatif telah diidentifikasi sebagai model yang umum disalahgunakan oleh pelaku kejahatan.

Karena Anda tidak menerapkan App Check untuk Firebase AI Logic, project Anda rentan terhadap penyalahgunaan model ini. Untuk membantu melindungi developer kami, Firebase memblokir akses ke model ini kecuali jika permintaan menyertakan token App Check yang valid (artinya App Check diterapkan untuk Firebase AI Logic).

Jika Anda ingin mengakses model yang menampilkan error, lakukan hal berikut:

1. Siapkan App Check untuk Firebase AI Logic. Untuk pengembangan lokal, pastikan Anda menyiapkan App Check penyedia debug.

   Menerapkan App Check sangat penting untuk membantu melindungi Gemini API dan Gemini model dari penyalahgunaan, dan penerapannya diperlukan untuk menghapus error ini.

2. Kirim ulang permintaan dari aplikasi Anda ke Firebase AI Logic.

   Permintaan ini akan mengirimkan token App Check yang valid, dan Anda tidak akan lagi mendapatkan error 403 - PERMISSION_DENIED ini.

3. Sebelum merilis aplikasi ke pengguna akhir, Anda harus menyiapkan penyedia pengesahan produksi (seperti App Attest, Play Integrity, atau reCAPTCHA Enterprise) agar pengguna akhir dapat mengakses fitur AI Anda saat App Check diterapkan.

Error 403: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

Jika Anda menerima error 403 - PERMISSION_DENIED yang menyatakan Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, artinya project Firebase Anda telah diidentifikasi sebagai tidak aktif dan Anda tidak menerapkan App Check untuk Firebase AI Logic.

"Project tidak aktif" adalah project yang mengaktifkan Firebase AI Logic, tetapi tidak memiliki penggunaan Firebase AI Logic baru-baru ini.

Karena Anda tidak menerapkan App Check untuk Firebase AI Logic, project Anda rentan terhadap penyalahgunaan Gemini API. Untuk membantu melindungi project Anda, Firebase menonaktifkan penggunaan Firebase AI Logic hingga Anda menerapkan App Check untuk Firebase AI Logic.

Jika Anda siap untuk mulai menggunakan Firebase AI Logic lagi, lakukan hal berikut:

1. Siapkan App Check untuk Firebase AI Logic. Untuk pengembangan lokal, pastikan Anda menyiapkan App Check penyedia debug.

   Menerapkan App Check sangat penting untuk membantu melindungi Gemini API dan Gemini model dari penyalahgunaan, dan penerapannya diperlukan untuk menghapus error ini.

2. Kirim ulang permintaan dari aplikasi Anda ke Firebase AI Logic.

   Permintaan ini akan mengirimkan token App Check yang valid, dan Anda tidak akan lagi mendapatkan error 403 - PERMISSION_DENIED ini.

3. Sebelum merilis aplikasi ke pengguna akhir, Anda harus menyiapkan penyedia pengesahan produksi (seperti App Attest, Play Integrity, atau reCAPTCHA Enterprise) agar pengguna akhir dapat mengakses fitur AI Anda saat App Check diterapkan.

Error 403: 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 dalam file/objek konfigurasi Firebase Anda milik project Firebase lain.

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 APIs & Services > Credentials panel di konsol Google Cloud.

Jika Anda menemukan bahwa kunci API tersebut tidak cocok, maka 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.

Error 403: 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 konfigurasi Firebase di aplikasi Anda memiliki batasan yang mencegahnya memanggil API yang diperlukan.

Untuk memperbaikinya, Anda harus memperbarui batasan kunci API di Google Cloud konsol agar menyertakan API yang diperlukan. Untuk Firebase AI Logic, Anda harus memastikan Firebase AI Logic API (firebasevertexai.googleapis.com) disertakan dalam daftar API terpilih yang dapat dipanggil menggunakan kunci API.

Ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka panel APIs & Services > Credentials.

2. Pilih kunci API yang dikonfigurasi untuk digunakan oleh aplikasi Anda (misalnya, "kunci iOS" untuk aplikasi iOS).

3. Di halaman Edit API key, temukan bagian API restrictions.

4. Pastikan opsi Restrict key dipilih. Jika tidak, kunci Anda tidak dibatasi, dan kemungkinan bukan sumber error.

5. Di menu drop-down Selected APIs, cari dan pilih Firebase AI Logic API untuk menambahkannya ke daftar API terpilih yang dapat dipanggil menggunakan kunci API.

6. Klik Save.

   Mungkin diperlukan waktu hingga lima menit agar perubahan diterapkan.

Error 404: Firebase AI Logic genai config not found

Jika Anda menerima error 404 yang menyatakan Firebase AI Logic genai config not found, biasanya berarti setelan untuk Firebase AI Logic salah dikonfigurasi atau tidak ada.

Berikut kemungkinan penyebab error ini:

• Anda belum menyiapkan project Firebase untuk penyedia Gemini API.

  Yang harus dilakukan:
  Di Firebase console, buka AI Services > AI Logic. Klik Get started, lalu pilih penyedia Gemini API yang Anda pilih. Aktifkan API, dan Firebase akan menyiapkan project Anda untuk penyedia tersebut. Setelah menyelesaikan alur kerja, coba permintaan Anda lagi.

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

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

Error 404: model "was not found or your project does not have access to it"?

Contoh: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."

Ada beberapa alasan berbeda mengapa Anda bisa mendapatkan error seperti ini.

• Nama model tidak valid

  • Penyebab: Nama model yang Anda berikan bukan nama model yang valid.

  • Solusi: Periksa nama model dan versi model Anda dengan daftar semua model yang didukung dan tersedia. Pastikan untuk memeriksa segmen dan urutannya dalam nama model. Contoh:

    • Nama model Gemini 3.x Pro terbaru: gemini-3.1-pro-preview (hanya tersedia dalam pratinjau)
    • Nama model Gemini 3.x Flash terbaru: gemini-3.7-flash
    • Nama model Gemini 3.x Flash‑Lite terbaru: gemini-3.5-flash-lite
    • Gemini 3.x Pro Image terbaru (alias "Nano Banana Pro") nama model: gemini-3-pro-image
    • Gemini 3.x Flash Image terbaru (alias "Nano Banana 2") nama model: gemini-3.1-flash-image
    • Nama model Gemini 3.x Flash‑Lite Image terbaru (alias "Nano Banana 2 Lite") : gemini-3.1-flash-lite-image
    • Gemini 2.5 Flash Image terbaru (alias "Nano Banana") nama model: gemini-2.5-flash-image

• Lokasi tidak valid (hanya berlaku jika menggunakan penyedia Agent Platform Gemini API (formerly Vertex AI))

  • Penyebab: Permintaan Anda mungkin mencoba mengakses model di lokasi tempat model tidak tersedia.

  • Solusi: Pastikan permintaan Anda mencoba mengakses model di tempat model tersedia.

    Saat menggunakan Agent Platform Gemini API (formerly Vertex AI), Anda dapat menentukan lokasi secara opsional untuk mengakses model selama inisialisasi. Jika Anda tidak menentukan lokasi, maka Firebase AI Logic akan menggunakan lokasi berikut secara default:

    • Saat menggunakan sintaksis inisialisasi "Agent Platform": global
    • Saat menggunakan sintaksis inisialisasi "Vertex AI" lama: us-central1

    Namun, tidak semua model didukung di lokasi default ini. Artinya, bergantung pada modelnya, Anda mungkin harus menetapkan lokasi tertentu secara eksplisit selama inisialisasi.

    • Gemini pratinjau dan eksperimental model: Hanya tersedia di lokasi global (kecuali untuk Live API model - lihat di bawah).

    • Gemini 3.x model: Hanya tersedia di lokasi global saat menggunakan Firebase AI Logic. Firebase AI Logic belum mendukung us dan eu lokasi.

    • Gemini 2.5 model: Tersedia di banyak lokasi.

    • Gemini Live API model: Hanya tersedia di lokasi us-central1. Lokasi global tidak didukung.

  Pelajari lebih lanjut cara me nentukan lokasi untuk mengakses model (termasuk cuplikan kode).

Error 429: "You exceeded your current quota, please check your plan and billing details" atau "Resource exhausted, please try again later."

Ada beberapa alasan berbeda mengapa Anda bisa mendapatkan error seperti ini.

• Anda melebihi kuota atau model yang Anda akses kelebihan beban karena permintaan dari orang lain.

  Tindakan yang harus diambil bergantung pada apakah Anda menggunakan Gemini Developer API atau Agent Platform Gemini API (formerly Vertex AI). Untuk mengetahui informasi selengkapnya tentang kuota dan cara meminta kuota tambahan, lihat Batas dan kuota.

  Jika Anda menggunakan Agent Platform Gemini API (formerly Vertex AI), dokumentasi Google Cloud memberikan beberapa konteks dan panduan tambahan untuk Kode error 429.

• Anda mencoba menggunakan model atau fitur yang memerlukan penagihan, tetapi project Firebase Anda menggunakan paket harga Spark.

  Jika menggunakan Gemini Developer API, Anda bisa mendapatkan akses terbatas ke model tertentu dan akses ke banyak fitur dasar saat menggunakan Gemini Developer API "paket gratis". Paket ini memungkinkan Anda memulai tanpa harus memberikan metode pembayaran, yang berarti Anda tidak perlu mengupgrade project Firebase ke paket harga Blaze bayar sesuai penggunaan.

  • Beberapa model tidak tersedia di Gemini Developer API "paket gratis" dan memerlukan "paket berbayar", yang berarti project Anda harus menggunakan paket harga Blaze bayar sesuai penggunaan. Misalnya, model berikut hampir selalu memerlukan penagihan:

    • Sebagian besar model pratinjau dan eksperimental
    • Model pembuatan gambar (model "Nano Banana")

  • Beberapa model menawarkan beberapa fitur dasar saat menggunakan Gemini Developer API "paket gratis", tetapi kemudian memerlukan "paket berbayar" untuk menggunakan fitur lanjutan. Contoh:

    • Saat menggunakan sebagian besar model Gemini 3.x, Grounding dengan Google Search atau Google Maps memerlukan penagihan.

  Pelajari tentang paket harga Firebase dan Gemini Developer API.

  Untuk mengetahui detail selengkapnya, lihat Gemini Developer API dokumentasi harga dan FAQ penagihan.