Beranda / Panduan / Gemini CLI dengan endpoint kustom dan model gratis

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

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

Windows PowerShell

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

Saat 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"
    }
  }
}
Penting: gunakan 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 atur GEMINI_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 Gemini API gratis dengan pemanggilan tool (Google AI Studio)
ModelGratis diKonteksBatas gratis (penawaran terbaik)AlatPemrosesan gambar
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaYaYa
Gemini Flash (latest alias)Google AI Studio-10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.5 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.8 LiveGoogle AI Studio-10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa

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 lain untuk Gemini CLI: pemanggilan tool dan konteks 128K+
ModelGratis diKonteksBatas gratis (penawaran terbaik)AlatPemrosesan gambar
GLM 5.3UnoRouter1M1 permintaan/menit
1 req/min per model
YaTidak
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 permintaan/menit
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/menit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/menit
50 permintaan/hari
Shared rate limit
YaTidak
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 permintaan/menit
250 permintaan/hari
70,000 token/menit
~6M
YaYa

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

MasalahPenyebabPerbaikan
Gemini CLI membuka login GoogleTipe autentikasi tidak diatur ke Gemini API keyPilih Use Gemini API key, atau atur security.auth.selectedType
"Metode autentikasi yang dipilih tidak valid"GOOGLE_API_KEY dipakai dengan base URL kustomGunakan GEMINI_API_KEY dan unset GOOGLE_API_KEY
Permintaan dikirim ke Google, bukan ke gatewayGOOGLE_GEMINI_BASE_URL tidak diatur di shell iniExport variabelnya, lalu jalankan gemini lagi
404 pada panggilan modelBase URL menyertakan /v1betaGunakan origin http://localhost:3001 saja
Panggilan tool gagalKeluarga Gemini dipetakan ke model dengan pemanggilan tool yang lemahPetakan keluarga ke model dari tabel di atas
"Semua model dibatasi laju setelah N percobaan"Semua kunci telah mencapai batasnyaTambahkan kunci dari lebih banyak penyedia, atau tunggu masa tunggu berakhir
Gunakan semua ini melalui satu kunci. FreeLLMAPI adalah router sumber terbuka yang Anda hosting sendiri. Router ini menempatkan semua paket gratis ini di balik satu endpoint yang kompatibel dengan OpenAI, dan beralih ke penyedia lain saat batas permintaan tercapai. Lihat katalog atau mulai.

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

Sumber

Semua panduan · Lihat semua model gratis