خانه / راهنماها / Gemini CLI با یک نقطه پایانی سفارشی و مدل‌های رایگان

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

http://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>
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 استفاده کنید. یک گزارش مشکل 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 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 کلید را در هدر 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»همه کلیدها به حد مجاز رسیده‌اندکلیدهای ارائه‌دهندگان بیشتر اضافه کنید، یا منتظر دوره‌های استراحت بمانید
هر یک از این‌ها را با یک کلید استفاده کنید. FreeLLMAPI یک روتر متن‌باز و میزبانی‌شده روی سرور خودتان است. این روتر همه این سطوح رایگان را پشت یک نقطه پایانی سازگار با OpenAI قرار می‌دهد و وقتی یک سرویس به محدودیت نرخ برسد، به سرویس بعدی منتقل می‌شود. مرور کاتالوگ یا اجرای زنده.

پرسش‌های متداول

آیا 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 کنید.

راهنماهای مرتبط

منابع

همه راهنماها · مرور همه مدل‌های رایگان