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

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 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 menjalankan gcloud CLI terhadap project Firebase Anda.

   Anda memerlukan project ID Firebase, yang dapat ditemukan di bagian atas 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, 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.

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 pembatasan yang mencegahnya memanggil API yang diperlukan.

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

Ikuti langkah-langkah berikut:

1. Di Google Cloud console, 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 ini bukan sumber error.

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

6. Klik Save.

   Mungkin diperlukan waktu hingga lima menit agar perubahan 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.

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.

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 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 konsol Firebase, buka Layanan AI > Logika AI. Klik Mulai, 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 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.

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

Misalnya: "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.

  • Perbaiki: Periksa nama model dan versi model Anda berdasarkan 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 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 model pratinjau dan eksperimental 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 Gemini pratinjau dan eksperimental ini.

  • Perbaikan: Saat Anda melakukan inisialisasi layanan Vertex AI Gemini API, tentukan lokasi global. Pelajari lebih lanjut cara menentukan 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. Misalnya (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 Amerika Serikat, dan beberapa lokasi Eropa (dan terkadang di lokasi lain jika project Anda memiliki opsi khusus).

  • Perbaikan: Saat 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 adalah 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 karena permintaan dari orang lain.

Tindakan yang harus dilakukan 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 frekuensi dan kuota.

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