Gemini CLI กับ custom endpoint และโมเดลฟรี
Gemini CLI คือ coding agent แบบโอเพนซอร์สของ Google สำหรับเทอร์มินัล สามารถส่งคำขอไปยัง base URL ที่กำหนดเองได้ คู่มือนี้ชี้ Gemini CLI ไปยัง FreeLLMAPI ซึ่งให้บริการ Gemini API แบบเนทีฟที่ /v1beta คำขอของคุณจะถูกส่งไปยังกลุ่มผู้ให้บริการฟรีของคุณ ซึ่งรวมคีย์ Gemini API ฟรีได้
โค้ด ชื่อโมเดล และป้ายกำกับของแคตตาล็อกสดจะแสดงเป็นภาษาอังกฤษ
การเปลี่ยนแปลงระดับฟรีของ Gemini CLI ในปี 2026
อ่านส่วนนี้ก่อน Google เปลี่ยนการใช้งาน Gemini CLI แบบฟรีในปี 2026 หน้าโควตาของ Gemini CLI ระบุว่า: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026."
ประกาศของ Google ระบุว่า Gemini CLI ยังใช้ได้ผ่านคีย์ Gemini API แบบชำระเงิน และสำหรับลูกค้าองค์กร
- การเข้าสู่ระบบ Google ในระดับฟรี: Gemini CLI ไม่ให้บริการบัญชีผู้บริโภคอีกต่อไป
- คีย์ Gemini API กับ base URL ที่กำหนดเอง: เอกสารการตั้งค่าของ Gemini CLI ยังระบุ
GOOGLE_GEMINI_BASE_URLเมื่อใช้ตัวแปรนี้ Gemini CLI จะส่งคำขอไปยัง URL ที่คุณตั้ง ไม่ใช่ไปยัง Google - คีย์ Gemini API ฟรี: Google AI Studio ยังแสดงระดับฟรีสำหรับ Gemini API FreeLLMAPI ใช้คีย์เหล่านั้นได้ พร้อมกับคีย์จากผู้ให้บริการอื่น
คู่มือนี้ใช้วิธีที่สอง FreeLLMAPI ตอบคำขอและส่งแต่ละรายการไปยังโมเดลฟรีในกลุ่มของคุณ
ขั้นตอนที่ 1: ติดตั้ง FreeLLMAPI และ Gemini CLI
ติดตั้งทั้งสองอย่าง
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliเปิด http://localhost:3001 เพิ่มคีย์ผู้ให้บริการฟรีอย่างน้อยสองรายในหน้า Keys คีย์ Google AI Studio ฟรีเป็นคีย์แรกที่ดี คัดลอกคีย์รวมของคุณจากหน้าเดียวกัน
ขั้นตอนที่ 2: ชี้ Gemini CLI ไปยังเกตเวย์
ตั้งค่าตัวแปรสภาพแวดล้อมสองตัวแล้วเริ่ม Gemini CLI base URL คือ origin ของเซิร์ฟเวอร์ โดยไม่มี /v1beta Gemini CLI จะเพิ่มเส้นทาง API เอง
macOS หรือ 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>"
geminiเมื่อ Gemini CLI ถามวิธียืนยันตัวตน ให้เลือก Use Gemini API key หากต้องการบันทึกตัวเลือกนี้ ให้ตั้งค่าใน ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY มี issue ของ Gemini CLI รายงานว่าเวอร์ชัน 0.44.x ล้มเหลวพร้อมข้อความ "Invalid auth method selected" เมื่อใช้ GOOGLE_API_KEY กับ GOOGLE_GEMINI_BASE_URL หากตั้งค่า GOOGLE_API_KEY ไว้ ให้ลบออกด้วย unset GOOGLE_API_KEYขั้นตอนที่ 3: แมปชื่อโมเดล Gemini เป็นโมเดลฟรี
Gemini CLI ขอชื่อโมเดล Gemini เช่น gemini-2.5-flash FreeLLMAPI ไม่ได้ส่งชื่อเหล่านี้ไปยัง Google โดยตรง ระบบแปลงชื่อผ่านการแมปตระกูล Gemini ในแท็บ Keys, Agents แมปแต่ละตระกูล (Pro, Flash และ Flash-Lite) ไปยัง Auto หรือไปยังโมเดลแคตตาล็อกที่ปักไว้
- เมื่อใช้ Auto เราเตอร์เลือกโมเดลฟรีสำหรับแต่ละคำขอ เมื่อผู้ให้บริการรายหนึ่งส่งข้อผิดพลาด 429 ระบบจะลองรายถัดไป
- ID แคตตาล็อกใช้เป็นชื่อโมเดลได้ด้วย เริ่ม Gemini CLI ด้วย
gemini -m <catalog-id>หรือตั้งค่าGEMINI_MODEL - Gemini CLI เป็นเอเจนต์ที่ใช้เครื่องมือ แมปตระกูลไปยังโมเดลที่รองรับการเรียกใช้เครื่องมือและมีหน้าต่างบริบทขนาดใหญ่
ตารางแรกแสดงโมเดล Gemini ฟรีในแคตตาล็อกในขณะนี้ ตารางที่สองแสดงโมเดลฟรีอื่นที่คุณแมปเป็นตระกูล Gemini ได้
| โมเดล | ฟรีบน | ขนาดบริบท | ขีดจำกัดฟรี (ข้อเสนอที่ดีที่สุด) | เครื่องมือ | การอ่านภาพ |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | ใช่ | ใช่ |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.8 Live | Google AI Studio | - | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
แสดง 8 จาก 14 โมเดลฟรีที่ตรงกัน ดูโมเดลทั้งหมด.
ข้อมูลสดจากแคตตาล็อก FreeLLMAPI (เวอร์ชัน 2026.11.19 ตรวจสอบเมื่อ 2026-11-19) ขีดจำกัดฟรีเปลี่ยนบ่อย แคตตาล็อกถูกตรวจสอบทุกวัน
| โมเดล | ฟรีบน | ขนาดบริบท | ขีดจำกัดฟรี (ข้อเสนอที่ดีที่สุด) | เครื่องมือ | การอ่านภาพ |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 คำขอ/นาที 1 req/min per model | ใช่ | ไม่ |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 คำขอ/นาที 40 RPM | ใช่ | ใช่ |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | ใช่ | ไม่ |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | ใช่ | ใช่ |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | ใช่ | ใช่ |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 คำขอ/นาที 50 คำขอ/วัน 50 req/day account-wide (1,000 after a $10 purchase) | ใช่ | ใช่ |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 คำขอ/นาที 50 คำขอ/วัน Shared rate limit | ใช่ | ไม่ |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 คำขอ/นาที 250 คำขอ/วัน 70,000 โทเคน/นาที ~6M | ใช่ | ใช่ |
แสดง 8 จาก 104 โมเดลฟรีที่ตรงกัน ดูโมเดลทั้งหมด.
ข้อมูลสดจากแคตตาล็อก FreeLLMAPI (เวอร์ชัน 2026.11.19 ตรวจสอบเมื่อ 2026-11-19) ขีดจำกัดฟรีเปลี่ยนบ่อย แคตตาล็อกถูกตรวจสอบทุกวัน
ขีดจำกัดของระดับฟรี Gemini
หน้าขีดจำกัดอัตราของ Google ระบุว่าขีดจำกัดใช้ต่อโปรเจกต์ ไม่ใช่ต่อคีย์ API การมีคีย์มากขึ้นในโปรเจกต์เดียวไม่ได้ให้โควตาเพิ่ม Google ยังระบุว่าไม่มีการรับประกันขีดจำกัด และคุณดูขีดจำกัดปัจจุบันได้ใน Google AI Studio โมเดลตัวอย่างมีขีดจำกัดต่ำกว่า
คีย์ Gemini Flash ฟรีอนุญาตคำขอจำนวนน้อยต่อวัน งาน Gemini CLI หนึ่งงานอาจส่งคำขอจำนวนมาก เพิ่มคีย์จากผู้ให้บริการอื่น เพื่อให้เราเตอร์ทำงานต่อได้เมื่อโควตา Gemini หมด พื้นผิวแบบเนทีฟรองรับ generateContent, streamGenerateContent พร้อม ?alt=sse, countTokens และรายการโมเดล
FreeLLMAPI รับคีย์ใน header x-goog-api-key ในรูปแบบ Bearer token หรือใน query parameter ?key= ของ Gemini ควรใช้ header เพราะคีย์ใน URL อาจรั่วไปยังประวัติ shell และ log ของ proxy
การแก้ปัญหา
| ปัญหา | สาเหตุ | วิธีแก้ |
|---|---|---|
| Gemini CLI เปิดหน้าเข้าสู่ระบบ Google | ประเภทการยืนยันตัวตนไม่ได้ตั้งเป็น Gemini API key | เลือก Use Gemini API key หรือตั้งค่า security.auth.selectedType |
| ข้อความ "Invalid auth method selected" | ใช้ GOOGLE_API_KEY กับ base URL ที่กำหนดเอง | ใช้ GEMINI_API_KEY และ unset GOOGLE_API_KEY |
| คำขอไปยัง Google ไม่ใช่เกตเวย์ | ไม่ได้ตั้งค่า GOOGLE_GEMINI_BASE_URL ใน shell นี้ | export ตัวแปร แล้วเริ่ม gemini อีกครั้ง |
404 ตอนเรียกโมเดล | base URL มี /v1beta | ใช้เฉพาะ origin http://localhost:3001 |
| การเรียกใช้เครื่องมือล้มเหลว | ตระกูล Gemini แมปไปยังโมเดลที่รองรับการเรียกใช้เครื่องมือได้ไม่ดี | แมปตระกูลไปยังโมเดลจากตารางด้านบน |
| ข้อความ "All models rate-limited after N attempts" | ทุกคีย์ถึงขีดจำกัดแล้ว | เพิ่มคีย์จากผู้ให้บริการอื่นเพิ่มเติม หรือรอช่วงพัก |
คำถามที่พบบ่อย
Gemini CLI ยังฟรีอยู่ไหม
Google ยกเลิกการใช้ Gemini CLI แบบฟรีผ่านการเข้าสู่ระบบ Google สำหรับผู้ใช้ที่ไม่ได้ชำระเงินและผู้ใช้ Google One เมื่อวันที่ 18 มิถุนายน 2026 CLI ยังรองรับ base URL ที่กำหนดเอง ดังนั้นจึงรันบนเกตเวย์ฟรีอย่าง FreeLLMAPI ได้
ฉันใช้ Gemini CLI กับ custom endpoint อย่างไร
ตั้ง GOOGLE_GEMINI_BASE_URL เป็น origin ของ endpoint และ GEMINI_API_KEY เป็นคีย์ของ endpoint นั้น จากนั้นเลือก Use Gemini API key endpoint ต้องรองรับ Gemini API แบบเนทีฟที่ /v1beta
Gemini CLI ใช้โมเดลที่ไม่ใช่ Gemini ได้ไหม
ได้ ผ่าน FreeLLMAPI เกตเวย์แมปชื่อตระกูล Gemini Pro, Flash และ Flash-Lite ไปยัง Auto หรือโมเดลแคตตาล็อกใดก็ได้ เช่น โมเดล Qwen หรือ GLM
ขีดจำกัดระดับฟรีของ Gemini API มีเท่าไร
Google กำหนดขีดจำกัดต่อโปรเจกต์ ไม่ใช่ต่อคีย์ และแสดงค่าปัจจุบันใน Google AI Studio ตารางในหน้านี้แสดงโมเดล Gemini ฟรีในขณะนี้และขีดจำกัดจากแคตตาล็อก FreeLLMAPI
ทำไมฉันถึงได้ 'Invalid auth method selected'
issue ของ Gemini CLI รายงานข้อผิดพลาดนี้ในเวอร์ชัน 0.44.x เมื่อใช้ GOOGLE_API_KEY กับ GOOGLE_GEMINI_BASE_URL ให้ใช้ GEMINI_API_KEY และ unset GOOGLE_API_KEY
คู่มือที่เกี่ยวข้อง
- free gemini api
- Gemini API เกินโควตา (429 RESOURCE_EXHAUSTED)
- วิธีใช้ Claude Code ฟรี
- ใช้ Codex CLI กับโมเดลฟรี
- API โมเดลเขียนโค้ดฟรีที่ดีที่สุด
แหล่งข้อมูล
- Gemini CLI docs: configuration reference (ตรวจสอบเมื่อ 20 November 2026)
- Gemini CLI docs: authentication (ตรวจสอบเมื่อ 20 November 2026)
- Gemini CLI docs: quota and pricing (ตรวจสอบเมื่อ 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (ตรวจสอบเมื่อ 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (ตรวจสอบเมื่อ 20 November 2026)
- Google AI Studio: rate limits (ตรวจสอบเมื่อ 20 November 2026)
- FreeLLMAPI docs: native Gemini API (ตรวจสอบเมื่อ 20 November 2026)