Gemini CLI با یک نقطه پایانی سفارشی و مدلهای رایگان
Gemini CLI یک عامل برنامهنویسی متنباز از Google برای ترمینال است. میتواند درخواستهای خود را به یک آدرس پایه سفارشی بفرستد. این راهنما Gemini CLI را به FreeLLMAPI وصل میکند. FreeLLMAPI مدل بومی Gemini API را روی /v1beta ارائه میدهد. درخواستهای شما سپس به مجموعه سطوح رایگان شما میروند، که میتواند شامل کلیدهای رایگان Gemini API هم باشد.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
تغییر 2026 در سطح رایگان Gemini CLI
ابتدا این را بخوانید. Google در 2026 استفاده رایگان از Gemini CLI را تغییر داد. صفحه سهمیه 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 با آدرس پایه سفارشی: مرجع پیکربندی Gemini CLI همچنان
GOOGLE_GEMINI_BASE_URLرا مستند میکند. با این متغیر، Gemini CLI درخواستهای خود را به آدرسی میفرستد که شما تنظیم کردهاید، نه به 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-clihttp://localhost:3001 را باز کنید. حداقل دو کلید ارائهدهنده رایگان را در صفحه Keys اضافه کنید. یک کلید رایگان Google AI Studio کلید اول خوبی است. کلید یکپارچه خود را از همان صفحه کپی کنید.
گام 2: Gemini CLI را به درگاه وصل کنید
دو متغیر محیطی را تنظیم کنید و Gemini CLI را اجرا کنید. آدرس پایه، مبدأ سرور است، بدون /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 استفاده کنید. یک گزارش مشکل 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 بفرستد، ارائهدهنده بعدی را امتحان میکند.
- شناسههای کاتالوگ هم به عنوان نام مدل کار میکنند. 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 کلید را در هدر x-goog-api-key، به عنوان Bearer token، یا در پارامتر کوئری ?key= مربوط به Gemini میپذیرد. هدر را ترجیح دهید، زیرا کلید در آدرس ممکن است در تاریخچه شل و لاگهای پروکسی نشت کند.
عیبیابی
| مشکل | علت | راهحل |
|---|---|---|
| Gemini CLI یک ورود Google باز میکند | نوع احراز هویت روی Gemini API key تنظیم نشده است | Use Gemini API key را انتخاب کنید، یا security.auth.selectedType را تنظیم کنید |
| «Invalid auth method selected» | GOOGLE_API_KEY با یک آدرس پایه سفارشی استفاده شده است | از GEMINI_API_KEY استفاده کنید و GOOGLE_API_KEY را unset کنید |
| درخواستها به Google میروند، نه به درگاه | GOOGLE_GEMINI_BASE_URL در این شل تنظیم نشده است | متغیر را export کنید، سپس gemini را دوباره اجرا کنید |
404 در فراخوانی مدل | آدرس پایه شامل /v1beta است | فقط مبدأ http://localhost:3001 را استفاده کنید |
| فراخوانی ابزارها خطا میدهد | خانواده Gemini به مدلی با فراخوانی ابزار ضعیف نگاشت شده است | خانواده را به مدلی از جدولهای بالا نگاشت کنید |
| «All models rate-limited after N attempts» | همه کلیدها به حد مجاز رسیدهاند | کلیدهای ارائهدهندگان بیشتر اضافه کنید، یا منتظر دورههای استراحت بمانید |
پرسشهای متداول
آیا Gemini CLI هنوز رایگان است؟
Google استفاده رایگان از Gemini CLI با ورود Google را برای کاربران پرداختنشده و کاربران Google One در 18 ژوئن 2026 پایان داد. این CLI هنوز از آدرس پایه سفارشی پشتیبانی میکند، پس میتواند روی یک درگاه رایگان مانند FreeLLMAPI اجرا شود.
چگونه Gemini CLI را با یک نقطه پایانی سفارشی استفاده کنم؟
GOOGLE_GEMINI_BASE_URL را روی مبدأ نقطه پایانی و GEMINI_API_KEY را روی کلید آن تنظیم کنید، سپس Use Gemini API key را انتخاب کنید. نقطه پایانی باید API بومی Gemini را روی /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» را میبینم؟
یک گزارش مشکل Gemini CLI این خطا را در نسخه 0.44.x گزارش میکند، وقتی GOOGLE_API_KEY همراه با GOOGLE_GEMINI_BASE_URL استفاده شود. از GEMINI_API_KEY استفاده کنید و GOOGLE_API_KEY را unset کنید.
راهنماهای مرتبط
- 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)