Panduan ini dirancang untuk membantu proses integrasi Google Gemini API dengan n8n dalam membangun sistem automasi berbasis AI yang stabil dan efisien. Di dalamnya mencakup langkah-langkah mulai dari aktivasi API di Google Cloud, pengaturan billing dan API key, hingga implementasi AI Agent menggunakan model Gemini yang tersedia saat ini.
Selain itu, panduan ini juga memberikan pemahaman praktis mengenai pemilihan model yang tepat, perbedaan antara model stabil dan preview, serta tips penggunaan agar workflow automation dapat berjalan tanpa kendala seperti error quota atau limit. Dengan mengikuti panduan ini, pengguna diharapkan dapat membangun pipeline AI yang siap digunakan untuk berbagai kebutuhan seperti pembuatan konten, analisis data, hingga integrasi ke sistem lainnya.
1. Aktivasi Gemini API di Google Cloud
Buka halaman berikut:
https://console.cloud.google.com/apis/library/generativelanguage.googleapis.com
- Pilih atau buat Project
- Klik tombol Enable
- Pastikan status berubah menjadi Enabled
Catatan Penting
Setelah mengaktifkan API atau menghubungkan billing, biasanya diperlukan waktu beberapa menit hingga sistem Google sepenuhnya aktif. Dalam kondisi ini:
- API sudah bisa diakses
- Daftar model sudah bisa ditampilkan
- Namun quota bisa belum sepenuhnya stabil
2. Aktivasi Billing
Buka:
https://console.cloud.google.com/billing
- Hubungkan project ke billing
- Pastikan status Active
Walaupun menggunakan free tier, aktivasi billing tetap wajib dilakukan. atau disable billing https://console.cloud.google.com/billing/projects
3. Membuat API Key
Buka:
https://console.cloud.google.com/apis/credentials
- Klik Create Credentials
- Pilih API Key
- Simpan API Key
Disarankan:
- Restrict API ke: Generative Language API
4. Verifikasi API
Gunakan perintah berikut:
curl "https://generativelanguage.googleapis.com/v1beta/models" \ -H "x-goog-api-key: API_KEY"
Jika berhasil, akan muncul daftar model seperti:
- gemini-2.5-flash
- gemini-2.5-pro
- gemini-2.0-flash
Ini menandakan API sudah aktif dengan benar.
5. Integrasi ke n8n
Menambahkan Credential
- Tambahkan node Google Gemini
- Masukkan API Key
Menggunakan AI Agent
- Gunakan node AI Agent
- Pilih model Gemini
Contoh Prompt
Buat caption Instagram tentang teknologi pendidikan yang menarik dan profesional
6. Rekomendasi Model
Model Utama (Disarankan)
- gemini-2.5-flash → cepat, stabil, cocok untuk automation
Alternatif Hemat
- gemini-2.5-flash-lite → lebih ringan dan hemat
Fallback Aman
- gemini-2.0-flash
- gemini-2.0-flash-lite
Model yang Tidak Disarankan
- Model dengan label preview (tidak stabil)
- Model image (sering tidak memiliki quota free)
7. Best Practice
- Gunakan model stabil untuk production
- Hindari model preview untuk automation jangka panjang
- Gunakan fallback model jika terjadi error
Contoh Strategi
Primary : gemini-2.5-flash Fallback : gemini-2.0-flash
8. Catatan Tambahan
- Setelah aktivasi billing, sistem Google bisa membutuhkan waktu beberapa menit untuk sinkronisasi
- Daftar model biasanya langsung tersedia, namun quota bisa menyesuaikan bertahap
- Jika terjadi error quota, tunggu beberapa menit atau buat API key baru
