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 Vertex AI 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 dalam permintaan multimodal Anda.Cloud Storage for Firebase 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 menjalankan gcloud CLI terhadap project Firebase Anda.

   Anda memerlukan project ID Firebase, yang dapat Anda temukan di bagian atas setelan settings Project settings 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 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: 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, "iOS key" 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.

   Perubahan mungkin memerlukan waktu hingga lima menit untuk 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 termasuk dalam 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 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 404: 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 Gemini API yang valid untuk digunakan dengan Firebase AI Logic client SDK.

Berikut adalah kemungkinan penyebab error ini:

• Anda belum menyiapkan project Firebase untuk Gemini Developer API.

  Yang harus dilakukan:
  Di konsol Firebase, buka AI Services > AI Logic. Klik Get started, 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 Gemini API 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 Gemini API yang digunakan oleh Firebase AI Logic.

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 terbaru: gemini-3.1-pro-preview (hanya tersedia dalam pratinjau)Gemini 3.x Pro
    • Nama model Gemini 3.x Flash terbaru: gemini-3.5-flash
    • Nama model Gemini 3.x Flash‑Lite terbaru: gemini-3.1-flash-lite
    • Nama model Gemini 3.x Pro Image (alias "Nano Banana Pro") terbaru: gemini-3-pro-image
    • Nama model Gemini 3.x Flash Image (alias "Nano Banana 2") terbaru: gemini-3.1-flash-image
    • Nama model Gemini 2.5 Flash Image (alias "Nano Banana") terbaru: gemini-2.5-flash-image

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

  • Penyebab: Setiap permintaan Anda yang menggunakan Vertex AI Gemini API harus menyertakan lokasi untuk mengakses model. Permintaan Anda mungkin mencoba mengakses model di lokasi tempat model tersebut tidak tersedia.

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

    Saat menggunakan Vertex AI Gemini API, Firebase AI Logic secara default menggunakan us-central1. Namun, tidak semua model didukung di us-central1. Artinya, bergantung pada modelnya, Anda mungkin perlu menetapkan lokasi tertentu secara eksplisit selama inisialisasi.

    • Gemini pratinjau dan eksperimental model: Menetapkan lokasi ke global diperlukan (kecuali untuk Live API model). Semua pratinjau dan eksperimental Gemini model (kecuali Live API model) hanya tersedia di lokasi global.

    • Gemini 3.x model: Menetapkan lokasi ke global diperlukan saat menggunakan Firebase AI Logic. Firebase AI Logic belum mendukung lokasi us dan eu.

    • Gemini 2.5 model: Menetapkan lokasi bersifat opsional. Jika Anda tidak menentukan lokasi, lokasi defaultnya adalah us-central1.

    • Gemini Live API model: Menetapkan lokasi bersifat opsional. Jika Anda tidak menentukan lokasi, lokasi defaultnya adalah us-central1. Perhatikan bahwa 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."

Error 429 menunjukkan bahwa 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 Vertex AI Gemini API. Untuk mengetahui informasi selengkapnya tentang kuota dan cara meminta kuota tambahan, lihat Batas dan kuota.

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