หน้าแรก / คู่มือ / Gemini CLI กับ custom endpoint และโมเดลฟรี

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

Windows 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 API ฟรีที่เรียกใช้เครื่องมือได้ (Google AI Studio)
โมเดลฟรีบนขนาดบริบทขีดจำกัดฟรี (ข้อเสนอที่ดีที่สุด)เครื่องมือการอ่านภาพ
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaใช่ใช่
Gemini Flash (latest alias)Google AI Studio-10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
Gemini 3.7 FlashGoogle AI Studio1M10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
Gemini 3.6 FlashGoogle AI Studio1M10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
Gemini 3.5 FlashGoogle AI Studio1M10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
Gemini 3.8 LiveGoogle AI Studio-10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่
Gemini 3.5 Flash LiteGoogle AI Studio1M15 คำขอ/นาที
20 คำขอ/วัน
250,000 โทเคน/นาที
~3M
ใช่ใช่

แสดง 8 จาก 14 โมเดลฟรีที่ตรงกัน ดูโมเดลทั้งหมด.

ข้อมูลสดจากแคตตาล็อก FreeLLMAPI (เวอร์ชัน 2026.11.19 ตรวจสอบเมื่อ 2026-11-19) ขีดจำกัดฟรีเปลี่ยนบ่อย แคตตาล็อกถูกตรวจสอบทุกวัน

โมเดลฟรีอื่นสำหรับ Gemini CLI: การเรียกใช้เครื่องมือและบริบท 128K ขึ้นไป
โมเดลฟรีบนขนาดบริบทขีดจำกัดฟรี (ข้อเสนอที่ดีที่สุด)เครื่องมือการอ่านภาพ
GLM 5.3UnoRouter1M1 คำขอ/นาที
1 req/min per model
ใช่ไม่
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 คำขอ/นาที
40 RPM
ใช่ใช่
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceใช่ไม่
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditใช่ใช่
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditใช่ใช่
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 คำขอ/นาที
50 คำขอ/วัน
50 req/day account-wide (1,000 after a $10 purchase)
ใช่ใช่
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 คำขอ/นาที
50 คำขอ/วัน
Shared rate limit
ใช่ไม่
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 คำขอ/นาที
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"ทุกคีย์ถึงขีดจำกัดแล้วเพิ่มคีย์จากผู้ให้บริการอื่นเพิ่มเติม หรือรอช่วงพัก
ใช้ทุกตัวในรายการนี้ผ่านคีย์เดียว FreeLLMAPI คือเราเตอร์โอเพนซอร์สที่คุณโฮสต์เอง รวมระดับฟรีทั้งหมดนี้ไว้หลังปลายทางเดียวที่เข้ากันได้กับ OpenAI และเปลี่ยนไปใช้ตัวอื่นเมื่อตัวใดตัวหนึ่งถูกจำกัดอัตรา ดูแคตตาล็อก หรือ เริ่มใช้งานจริง.

คำถามที่พบบ่อย

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

คู่มือที่เกี่ยวข้อง

แหล่งข้อมูล

คู่มือทั้งหมด · ดูโมเดลฟรีทั้งหมด