Laman utama / Panduan / Gemini CLI dengan titik akhir tersuai dan model percuma

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

Buka 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>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Apabila 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"
    }
  }
}
Penting: gunakan 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 tetapkan GEMINI_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 API Gemini percuma dengan panggilan alat (Google AI Studio)
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaYaYa
Gemini Flash (latest alias)Google AI Studio-10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.5 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.8 LiveGoogle AI Studio-10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa

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 lain untuk Gemini CLI: panggilan alat dan konteks 128K+
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
GLM 5.3UnoRouter1M1 permintaan/minit
1 req/min per model
YaTidak
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 permintaan/minit
40 RPM
YaYa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceYaTidak
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditYaYa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditYaYa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 permintaan/minit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/minit
50 permintaan/hari
Shared rate limit
YaTidak
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 permintaan/minit
250 permintaan/hari
70,000 token/minit
~6M
YaYa

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

MasalahPuncaPembetulan
Gemini CLI membuka log masuk GoogleJenis pengesahan tidak ditetapkan kepada kunci API GeminiPilih Use Gemini API key, atau tetapkan security.auth.selectedType
Ralat "Invalid auth method selected"GOOGLE_API_KEY digunakan dengan URL asas tersuaiGunakan GEMINI_API_KEY dan nyahtetapkan GOOGLE_API_KEY
Permintaan pergi ke Google, bukan ke get laluanGOOGLE_GEMINI_BASE_URL tidak ditetapkan dalam shell iniEksport pembolehubah, kemudian mulakan semula gemini
404 pada panggilan modelURL asas mengandungi /v1betaGunakan asal http://localhost:3001 sahaja
Panggilan alat gagalKeluarga Gemini dipetakan kepada model dengan panggilan alat yang lemahPetakan keluarga kepada model dari jadual di atas
"Semua model mencapai had kadar selepas N percubaan"Semua kunci telah mencapai hadTambah kunci dari lebih ramai pembekal, atau tunggu tempoh rehat
Guna setiap satu daripada ini melalui satu kunci. FreeLLMAPI ialah penghala sumber terbuka yang anda hoskan sendiri. Ia meletakkan semua peringkat percuma ini di belakang satu titik akhir serasi OpenAI dan beralih ke pembekal lain apabila had kadar dicapai. Layari katalog atau mula sekarang.

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

Sumber

Semua panduan · Lihat semua model percuma