Gemini CLI dengan titik akhir tersuai dan model percuma
Gemini CLI ialah ejen pengekodan sumber terbuka Google untuk terminal. Ia boleh menghantar permintaannya ke URL asas tersuai. Panduan ini menghalakan Gemini CLI ke FreeLLMAPI, yang menyediakan API Gemini asal pada /v1beta. Permintaan anda kemudian pergi ke kumpulan pembekal percuma anda, yang boleh termasuk kunci API Gemini percuma.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Perubahan 2026 pada peringkat percuma Gemini CLI
Baca ini dahulu. Google menukar penggunaan percuma Gemini CLI pada 2026. Halaman kuota Gemini CLI menyatakan: "Pengguna peringkat tidak berbayar dan Google One: Gemini CLI digantikan oleh Antigravity CLI pada 18 Jun 2026."
Pengumuman Google menyatakan bahawa Gemini CLI kekal tersedia melalui kunci API Gemini berbayar dan untuk pelanggan perusahaan.
- Log masuk Google pada peringkat percuma: tidak lagi dilayan oleh Gemini CLI untuk akaun pengguna.
- Kunci API Gemini dengan URL asas tersuai: rujukan konfigurasi Gemini CLI masih mendokumenkan
GOOGLE_GEMINI_BASE_URL. Dengan pembolehubah ini, Gemini CLI menghantar permintaannya ke URL yang anda tetapkan, bukan ke Google. - Kunci API Gemini percuma: Google AI Studio masih menyenaraikan peringkat percuma untuk API Gemini. FreeLLMAPI boleh menggunakan kunci tersebut, bersama kunci dari pembekal lain.
Panduan ini menggunakan kaedah kedua. FreeLLMAPI menjawab permintaan dan menghantar setiap satu ke model percuma dalam kumpulan anda.
Langkah 1: Pasang FreeLLMAPI dan Gemini CLI
Pasang kedua-duanya
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliBuka http://localhost:3001. Tambah sekurang-kurangnya dua kunci pembekal percuma pada halaman Keys. Kunci Google AI Studio percuma ialah kunci pertama yang baik. Salin kunci bersatu anda dari halaman yang sama.
Langkah 2: Halakan Gemini CLI ke get laluan
Tetapkan dua pembolehubah persekitaran dan mulakan Gemini CLI. URL asas ialah asal pelayan, tanpa /v1beta. Gemini CLI menambah laluan 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>"
geminiApabila Gemini CLI meminta kaedah pengesahan, pilih Use Gemini API key. Untuk menyimpan pilihan, tetapkannya dalam ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY. Satu isu Gemini CLI melaporkan bahawa versi 0.44.x gagal dengan "Invalid auth method selected" apabila GOOGLE_API_KEY digunakan bersama GOOGLE_GEMINI_BASE_URL. Jika GOOGLE_API_KEY ditetapkan, buangnya dengan unset GOOGLE_API_KEY.Langkah 3: Petakan nama model Gemini kepada model percuma
Gemini CLI meminta nama model Gemini, contohnya gemini-2.5-flash. FreeLLMAPI tidak menghantar nama ini terus kepada Google. Ia menyelesaikannya melalui peta keluarga Gemini pada tab Keys, Agents. Petakan setiap keluarga (Pro, Flash dan Flash-Lite) kepada Auto atau kepada model katalog yang ditetapkan.
- Dengan Auto, penghala memilih model percuma untuk setiap permintaan. Apabila satu pembekal menghantar ralat 429, ia mencuba yang seterusnya.
- ID katalog juga berfungsi sebagai nama model. Mulakan Gemini CLI dengan
gemini -m <catalog-id>, atau tetapkanGEMINI_MODEL. - Gemini CLI ialah ejen dengan alat. Petakan keluarga kepada model yang menyokong panggilan alat dan tetingkap konteks yang besar.
Jadual pertama menunjukkan model Gemini percuma dalam katalog hari ini. Jadual kedua menunjukkan model percuma lain yang boleh anda petakan kepada keluarga Gemini.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.8 Live | Google AI Studio | - | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
Memaparkan 8 daripada 14 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/minit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/minit 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/minit 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/minit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
Memaparkan 8 daripada 104 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
Had peringkat percuma Gemini
Halaman had kadar Google menyatakan bahawa had digunakan setiap projek, bukan setiap kunci API. Lebih banyak kunci dalam satu projek tidak memberikan lebih banyak kuota. Google juga menyatakan bahawa had tidak dijamin dan anda boleh melihat had semasa dalam Google AI Studio. Model pratonton mempunyai had yang lebih rendah.
Kunci Gemini Flash percuma membenarkan sedikit permintaan sehari. Satu tugas Gemini CLI boleh menghantar banyak permintaan. Tambah kunci dari pembekal lain, supaya penghala boleh terus berjalan apabila kuota Gemini habis. Permukaan asal menyokong generateContent, streamGenerateContent dengan ?alt=sse, countTokens dan senarai model.
FreeLLMAPI menerima kunci dalam header x-goog-api-key, sebagai token Bearer atau dalam parameter pertanyaan ?key= Gemini. Utamakan header, kerana kunci dalam URL boleh bocor ke sejarah shell dan log proksi.
Penyelesaian masalah
| Masalah | Punca | Pembetulan |
|---|---|---|
| Gemini CLI membuka log masuk Google | Jenis pengesahan tidak ditetapkan kepada kunci API Gemini | Pilih Use Gemini API key, atau tetapkan security.auth.selectedType |
| Ralat "Invalid auth method selected" | GOOGLE_API_KEY digunakan dengan URL asas tersuai | Gunakan GEMINI_API_KEY dan nyahtetapkan GOOGLE_API_KEY |
| Permintaan pergi ke Google, bukan ke get laluan | GOOGLE_GEMINI_BASE_URL tidak ditetapkan dalam shell ini | Eksport pembolehubah, kemudian mulakan semula gemini |
404 pada panggilan model | URL asas mengandungi /v1beta | Gunakan asal http://localhost:3001 sahaja |
| Panggilan alat gagal | Keluarga Gemini dipetakan kepada model dengan panggilan alat yang lemah | Petakan keluarga kepada model dari jadual di atas |
| "Semua model mencapai had kadar selepas N percubaan" | Semua kunci telah mencapai had | Tambah kunci dari lebih ramai pembekal, atau tunggu tempoh rehat |
Soalan lazim
Adakah Gemini CLI masih percuma?
Google menamatkan penggunaan Gemini CLI percuma dengan log masuk Google untuk pengguna tidak berbayar dan pengguna Google One pada 18 Jun 2026. CLI masih menyokong URL asas tersuai, jadi ia boleh berjalan pada get laluan percuma seperti FreeLLMAPI.
Bagaimana saya menggunakan Gemini CLI dengan titik akhir tersuai?
Tetapkan GOOGLE_GEMINI_BASE_URL kepada asal titik akhir dan GEMINI_API_KEY kepada kuncinya, kemudian pilih Use Gemini API key. Titik akhir mesti menggunakan API Gemini asal pada /v1beta.
Bolehkah Gemini CLI menggunakan model yang bukan Gemini?
Ya, melalui FreeLLMAPI. Get laluan memetakan nama keluarga Gemini Pro, Flash dan Flash-Lite kepada Auto atau kepada mana-mana model katalog, contohnya model Qwen atau GLM.
Apakah had peringkat percuma API Gemini?
Google menetapkan had setiap projek, bukan setiap kunci, dan menunjukkan nilai semasa dalam Google AI Studio. Jadual di halaman ini menunjukkan model Gemini percuma hari ini dan had mereka dari katalog FreeLLMAPI.
Mengapa saya mendapat 'Invalid auth method selected'?
Satu isu Gemini CLI melaporkan ralat ini pada versi 0.44.x apabila GOOGLE_API_KEY digunakan bersama GOOGLE_GEMINI_BASE_URL. Gunakan GEMINI_API_KEY dan nyahtetapkan GOOGLE_API_KEY.
Panduan berkaitan
- free gemini api
- Kuota Gemini API melebihi (429 RESOURCE_EXHAUSTED)
- Cara guna Claude Code secara percuma
- Gunakan Codex CLI dengan model percuma
- Model API pengekodan percuma terbaik
Sumber
- Gemini CLI docs: configuration reference (disemak 20 November 2026)
- Gemini CLI docs: authentication (disemak 20 November 2026)
- Gemini CLI docs: quota and pricing (disemak 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (disemak 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (disemak 20 November 2026)
- Google AI Studio: rate limits (disemak 20 November 2026)
- FreeLLMAPI docs: native Gemini API (disemak 20 November 2026)