Gemini CLI dengan endpoint kustom dan model gratis
Gemini CLI adalah agen koding sumber terbuka dari Google untuk terminal. CLI ini dapat mengirim permintaannya ke base URL kustom. Panduan ini mengarahkan Gemini CLI ke FreeLLMAPI, yang menyajikan API Gemini native di /v1beta. Permintaan Anda kemudian dikirim ke kumpulan paket penyedia gratis Anda, yang dapat mencakup kunci Gemini API gratis.
Kode, nama model, dan label katalog langsung ditampilkan dalam bahasa Inggris.
Perubahan 2026 pada paket gratis Gemini CLI
Baca ini terlebih dahulu. Google mengubah penggunaan gratis Gemini CLI pada 2026. Halaman kuota Gemini CLI menyatakan: "Pengguna paket tanpa bayar dan Google One: Gemini CLI digantikan oleh Antigravity CLI pada 18 Juni 2026."
Pengumuman Google menyatakan bahwa Gemini CLI tetap tersedia melalui kunci Gemini API berbayar dan untuk pelanggan perusahaan.
- Login Google pada paket gratis: tidak lagi dilayani oleh Gemini CLI untuk akun konsumen.
- Kunci Gemini API dengan base URL kustom: referensi konfigurasi Gemini CLI masih mendokumentasikan
GOOGLE_GEMINI_BASE_URL. Dengan variabel ini, Gemini CLI mengirim permintaannya ke URL yang Anda atur, bukan ke Google. - Kunci Gemini API gratis: Google AI Studio masih mencantumkan paket gratis untuk Gemini API. FreeLLMAPI dapat memakai kunci tersebut, bersama kunci dari penyedia lain.
Panduan ini memakai metode kedua. FreeLLMAPI menjawab permintaan dan mengirim setiap permintaan ke model gratis dalam kumpulan Anda.
Langkah 1: Pasang FreeLLMAPI dan Gemini CLI
Pasang keduanya
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliBuka http://localhost:3001. Tambahkan minimal dua kunci penyedia gratis di halaman Keys. Kunci Google AI Studio gratis adalah kunci pertama yang baik. Salin kunci terpadu Anda dari halaman yang sama.
Langkah 2: Arahkan Gemini CLI ke gateway
Atur dua variabel lingkungan dan jalankan Gemini CLI. Base URL adalah origin server, tanpa /v1beta. Gemini CLI menambahkan jalur API sendiri.
macOS atau Linux
export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiSaat Gemini CLI meminta metode autentikasi, pilih Use Gemini API key. Untuk menyimpan pilihan, atur di ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY. Sebuah isu Gemini CLI melaporkan bahwa versi 0.44.x gagal dengan "Metode autentikasi yang dipilih tidak valid" saat GOOGLE_API_KEY dipakai bersama GOOGLE_GEMINI_BASE_URL. Jika GOOGLE_API_KEY diatur, hapus dengan unset GOOGLE_API_KEY.Langkah 3: Petakan nama model Gemini ke model gratis
Gemini CLI meminta nama model Gemini, misalnya gemini-2.5-flash. FreeLLMAPI tidak mengirim nama ini langsung ke Google. FreeLLMAPI menyelesaikannya melalui peta keluarga Gemini di tab Keys, Agents. Petakan setiap keluarga (Pro, Flash, dan Flash-Lite) ke Auto atau ke model katalog yang ditetapkan.
- Dengan Auto, router memilih model gratis untuk setiap permintaan. Saat satu penyedia mengirim error 429, router mencoba penyedia berikutnya.
- ID katalog juga berfungsi sebagai nama model. Jalankan Gemini CLI dengan
gemini -m <catalog-id>, atau aturGEMINI_MODEL. - Gemini CLI adalah agen dengan tool. Petakan keluarga ke model dengan pemanggilan tool dan jendela konteks yang besar.
Tabel pertama menampilkan model Gemini gratis dalam katalog saat ini. Tabel kedua menampilkan model gratis lain yang dapat Anda petakan ke keluarga Gemini.
| Model | Gratis di | Konteks | Batas gratis (penawaran terbaik) | Alat | Pemrosesan gambar |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.8 Live | Google AI Studio | - | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 permintaan/menit 20 permintaan/hari 250,000 token/menit ~3M | Ya | Ya |
Menampilkan 8 dari 14 model gratis yang cocok. Lihat semua model.
Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.
| Model | Gratis di | Konteks | Batas gratis (penawaran terbaik) | Alat | Pemrosesan gambar |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/menit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/menit 40 RPM | Ya | Ya |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ya | Tidak |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/menit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 permintaan/menit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/menit 250 permintaan/hari 70,000 token/menit ~6M | Ya | Ya |
Menampilkan 8 dari 104 model gratis yang cocok. Lihat semua model.
Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.
Batas paket gratis Gemini
Halaman batas laju Google menyatakan bahwa batas berlaku per proyek, bukan per kunci API. Lebih banyak kunci dalam satu proyek tidak memberi kuota tambahan. Google juga menyatakan bahwa batas tidak dijamin dan Anda dapat melihat batas Anda saat ini di Google AI Studio. Model pratinjau memiliki batas yang lebih rendah.
Kunci Gemini Flash gratis mengizinkan sedikit permintaan per hari. Satu tugas Gemini CLI dapat mengirim banyak permintaan. Tambahkan kunci dari penyedia lain, agar router dapat terus berjalan saat kuota Gemini habis. Permukaan native mendukung generateContent, streamGenerateContent dengan ?alt=sse, countTokens, dan daftar model.
FreeLLMAPI menerima kunci di header x-goog-api-key, sebagai token Bearer, atau di parameter query ?key= milik Gemini. Utamakan header, karena kunci di URL dapat bocor ke riwayat shell dan log proxy.
Pemecahan masalah
| Masalah | Penyebab | Perbaikan |
|---|---|---|
| Gemini CLI membuka login Google | Tipe autentikasi tidak diatur ke Gemini API key | Pilih Use Gemini API key, atau atur security.auth.selectedType |
| "Metode autentikasi yang dipilih tidak valid" | GOOGLE_API_KEY dipakai dengan base URL kustom | Gunakan GEMINI_API_KEY dan unset GOOGLE_API_KEY |
| Permintaan dikirim ke Google, bukan ke gateway | GOOGLE_GEMINI_BASE_URL tidak diatur di shell ini | Export variabelnya, lalu jalankan gemini lagi |
404 pada panggilan model | Base URL menyertakan /v1beta | Gunakan origin http://localhost:3001 saja |
| Panggilan tool gagal | Keluarga Gemini dipetakan ke model dengan pemanggilan tool yang lemah | Petakan keluarga ke model dari tabel di atas |
| "Semua model dibatasi laju setelah N percobaan" | Semua kunci telah mencapai batasnya | Tambahkan kunci dari lebih banyak penyedia, atau tunggu masa tunggu berakhir |
Pertanyaan yang sering diajukan
Apakah Gemini CLI masih gratis?
Google mengakhiri penggunaan Gemini CLI gratis dengan login Google untuk pengguna paket tanpa bayar dan Google One pada 18 Juni 2026. CLI tetap mendukung base URL kustom, sehingga dapat berjalan di gateway gratis seperti FreeLLMAPI.
Bagaimana cara memakai Gemini CLI dengan endpoint kustom?
Atur GOOGLE_GEMINI_BASE_URL ke origin endpoint dan GEMINI_API_KEY ke kuncinya, lalu pilih Use Gemini API key. Endpoint harus memakai API Gemini native di /v1beta.
Dapatkah Gemini CLI memakai model yang bukan Gemini?
Bisa, melalui FreeLLMAPI. Gateway memetakan nama keluarga Gemini Pro, Flash, dan Flash-Lite ke Auto atau ke model katalog mana pun, misalnya model Qwen atau GLM.
Berapa batas paket gratis Gemini API?
Google menetapkan batas per proyek, bukan per kunci, dan menampilkan nilai saat ini di Google AI Studio. Tabel di halaman ini menampilkan model Gemini gratis saat ini dan batasnya dari katalog FreeLLMAPI.
Mengapa saya mendapatkan 'Metode autentikasi yang dipilih tidak valid'?
Sebuah isu Gemini CLI melaporkan error ini pada versi 0.44.x saat GOOGLE_API_KEY dipakai bersama GOOGLE_GEMINI_BASE_URL. Gunakan GEMINI_API_KEY dan unset GOOGLE_API_KEY.
Panduan terkait
- free gemini api
- Kuota Gemini API terlampaui (429 RESOURCE_EXHAUSTED)
- Cara memakai Claude Code secara gratis
- Gunakan Codex CLI dengan model gratis
- API model coding gratis terbaik
Sumber
- Gemini CLI docs: configuration reference (diperiksa 20 November 2026)
- Gemini CLI docs: authentication (diperiksa 20 November 2026)
- Gemini CLI docs: quota and pricing (diperiksa 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (diperiksa 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (diperiksa 20 November 2026)
- Google AI Studio: rate limits (diperiksa 20 November 2026)
- FreeLLMAPI docs: native Gemini API (diperiksa 20 November 2026)