"API key not valid. Please pass a valid API key." — kalimat Gemini yang paling tidak membantu. Biasanya kuncinya MEMANG valid; ada sesuatu di sekitarnya yang salah: pembatasan perujuk, Generative Language API belum diaktifkan, atau kunci AI Studio dikirim ke endpoint Vertex. Periksa daftar berikut secara berurutan.
Error
{
"error": {
"code": 400,
"message": "API key not valid. Please pass a valid API key.",
"status": "INVALID_ARGUMENT",
"details": [{ "reason": "API_KEY_INVALID" }]
}
}Ringkasan penyebab dan perbaikan
| Penyebab | Perbaikan |
|---|---|
| Pembatasan kunci (perujuk HTTP / IP) memblokir panggilan server | Di Google Cloud Console → Credentials, kunci yang dibatasi berdasarkan perujuk akan menolak permintaan dari sisi server. Gunakan kunci tanpa pembatasan atau batasi berdasarkan API. |
| Generative Language API belum diaktifkan pada project | Aktifkan "Generative Language API" untuk kunci bergaya AI Studio. |
| Ketidakcocokan kunci AI Studio dan endpoint Vertex AI | Kunci AIza… memanggil generativelanguage.googleapis.com; Vertex menggunakan OAuth/service account pada host yang berbeda. Jangan menukar keduanya. |
| Wilayah tidak didukung | Kunci AI Studio tidak berfungsi dari setiap negara; periksa ketersediaan atau rutekan melalui gateway. |
| Konfigurasi variabel lingkungan (tanda kutip/spasi/nama variabel yang salah) | Jalankan print(repr(key)) di dalam proses yang gagal; ekspor ulang dengan bersih. |
Uji kunci secara terisolasi
Satu curl ke endpoint REST akan memberi tahu apakah kuncinya sendiri baik-baik saja:
curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"contents":[{"parts":[{"text":"ping"}]}]}' | head -c 400Periksa pembatasan dan API yang diaktifkan
Cloud Console → APIs & Services → Credentials: buka kuncinya. Jika Application restrictions menampilkan "HTTP referrers", panggilan server akan menghasilkan 400 — ubah ke None atau berbasis IP. Kemudian pastikan Generative Language API diaktifkan pada project yang sama.
Jika Anda tetap memerlukan satu kunci untuk banyak model
Jika Anda mengelola kunci Gemini + Claude + GPT sekaligus, gateway yang kompatibel dengan OpenAI menyatukannya menjadi satu kredensial — kode yang sama, satu base_url, tanpa memerlukan project Google Cloud.
Jika Anda melakukan panggilan melalui Kunavo
Kunavo menyediakan Gemini 2.5 Flash dan Pro di balik endpoint kompatibel OpenAI dan kunci sk-kn yang sama seperti Claude dan GPT — tanpa project Google Cloud, tanpa pembatasan kunci untuk di-debug, dan dapat digunakan dari wilayah tempat kunci AI Studio tidak ditawarkan. Tarifnya jauh di bawah harga daftar Google, dan penyiapannya hanya tiga bidang di SDK OpenAI mana pun.
Pertanyaan umum
Kunci Gemini saya berfungsi secara lokal tetapi gagal di produksi — mengapa?
Biasanya karena pembatasan perujuk/IP (IP produksi tidak diizinkan), berkas lingkungan yang berbeda di produksi, atau project produksi belum mengaktifkan Generative Language API. Bandingkan repr kunci dan ID project di antara lingkungan.
Apakah Gemini API gratis?
AI Studio memiliki tingkat gratis dengan kuota per menit yang ketat; lalu lintas produksi memerlukan penagihan yang diaktifkan (atau gateway). Jika Anda mendapatkan error kuota, bukan error kunci, lihat panduan RESOURCE_EXHAUSTED kami.
Panduan terkait
Detail semantik error lainnya tersedia di referensi error; mendapatkan kunci hanya perlu satu menit melalui pendaftaran dan panduan autentikasi.