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 adalah solusi untuk memperbaiki project Anda dan menyediakan agen layanan ini dengan benar sehingga Anda dapat mulai menyertakan Cloud Storage for Firebase URL 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 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, dan lalu coba lagi mengirim 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 untuk 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.

   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 halaman Firebase 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 lagi permintaan Anda.

• 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 lagi permintaan Anda.

• 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-pro-image-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.

  • Perbaikan: 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 pratinjau Gemini 3.1 Pro adalah gemini-3.1-pro-preview.
    • Nama model pratinjau Gemini 3 Flash adalah gemini-3-flash-preview.
    • Nama model pratinjau "Nano Banana Pro" adalah gemini-3-pro-image-preview.
    • Nama model pratinjau "Nano Banana 2" adalah gemini-3.1-flash-image-preview.
    • Nama model "Nano Banana" adalah gemini-2.5-flash-image.

• Lokasi tidak valid (hanya berlaku jika menggunakan penyedia Vertex AI Gemini API dan model pratinjau atau eksperimental)

  • Penyebab: Anda menggunakan versi pratinjau atau eksperimental dari model (misalnya, gemini-3.1-pro-preview dan gemini-3.1-flash-image-preview), dan Anda tidak menentukan lokasi global.

    Jika Anda menggunakan Vertex AI Gemini API, semua pratinjau dan eksperimental model Gemini (kecuali model Gemini Live) hanya tersedia di lokasi global. Namun, karena Firebase AI Logic secara default menggunakan lokasi us-central1, Anda perlu menentukan lokasi global secara eksplisit saat melakukan inisialisasi layanan backend Vertex AI Gemini API dalam kode Anda saat menggunakan model pratinjau dan eksperimental Gemini ini.

  • Perbaikan: Saat Anda melakukan inisialisasi layanan Vertex AI Gemini API, tentukan lokasi global. Pelajari lebih lanjut cara me nentukan lokasi untuk mengakses model (termasuk cuplikan kode).

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

  • Penyebab: Anda menggunakan model yang tidak didukung di lokasi tempat Anda mencoba mengaksesnya.

    Jika Anda menggunakan Vertex AI Gemini API, beberapa model hanya tersedia di lokasi tertentu. Contoh (tetapi tidak lengkap):

    • Model Imagen tidak didukung di global lokasi.
    • Model Gemini Live API (seperti gemini-2.0-flash-live-preview-04-09) hanya didukung di lokasi us-central1.
    • Model Gemini 2.5 (seperti gemini-2.5-pro) hanya tersedia di lokasi global, lokasi AS, dan beberapa lokasi Eropa (dan terkadang di lokasi lain jika project Anda memiliki opsi khusus).

  • Perbaikan: Saat Anda melakukan inisialisasi layanan Vertex AI Gemini API, pastikan Anda menentukan lokasi yang didukung untuk model yang Anda gunakan. Pelajari lebih lanjut cara menentukan lokasi untuk mengakses model (termasuk cuplikan kode) dan lokasi yang didukung untuk model.

    Perhatikan bahwa Firebase AI Logic secara default menggunakan lokasi us-central1.

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