Gemini CLI مع نقطة وصول مخصصة ونماذج مجانية
Gemini CLI وكيل برمجة مفتوح المصدر من Google يعمل في الطرفية. يستطيع إرسال طلباته إلى رابط أساسي مخصص. يوجه هذا الدليل Gemini CLI إلى FreeLLMAPI، الذي يقدم واجهة Gemini API الأصلية على /v1beta. تذهب طلباتك بعد ذلك إلى مجموعة المزوّدين المجانيين لديك، وقد تشمل مفاتيح Gemini API المجانية.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
تغيير عام 2026 في المستوى المجاني لـ Gemini CLI
اقرأ هذا أولًا. غيّرت Google الاستخدام المجاني لـ Gemini CLI في عام 2026. تقول صفحة حصص Gemini CLI: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026." أي: "مستخدمو المستوى غير المدفوع ومستخدمو Google One: حل Antigravity CLI محل Gemini CLI في 18 يونيو 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 مسار الواجهة بنفسه.
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، أو في معامل الاستعلام ?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 |
| تذهب الطلبات إلى Google، لا إلى البوابة | GOOGLE_GEMINI_BASE_URL غير مضبوط في هذه الجلسة | صدّر المتغير، ثم شغّل gemini مرة أخرى |
الخطأ 404 عند استدعاءات النماذج | الرابط الأساسي يحتوي على /v1beta | استخدم أصل الخادم http://localhost:3001 فقط |
| استدعاءات الأدوات تفشل | عائلة Gemini مربوطة بنموذج ضعيف في استدعاء الأدوات | اربط العائلة بنموذج من الجداول أعلاه |
| "وصلت جميع النماذج إلى حد الطلبات بعد N محاولة" | وصلت كل المفاتيح إلى حدها | أضف مفاتيح من مزوّدين آخرين، أو انتظر فترات التهدئة |
الأسئلة الشائعة
هل Gemini CLI ما زال مجانيًا؟
أنهت Google الاستخدام المجاني لـ Gemini CLI عبر تسجيل دخول Google للمستخدمين غير المدفوعين ومستخدمي Google One في 18 يونيو 2026. ما زالت الأداة تدعم رابطًا أساسيًا مخصصًا، لذلك يمكنها العمل عبر بوابة مجانية مثل FreeLLMAPI.
كيف أستخدم Gemini CLI مع نقطة وصول مخصصة؟
اضبط GOOGLE_GEMINI_BASE_URL على أصل نقطة الوصول، وGEMINI_API_KEY على مفتاحها، ثم اختر Use Gemini API key. يجب أن تتحدث نقطة الوصول واجهة 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'؟
يذكر بلاغ في Gemini CLI هذا الخطأ في الإصدار 0.44.x عند استخدام GOOGLE_API_KEY مع GOOGLE_GEMINI_BASE_URL. استخدم GEMINI_API_KEY، وألغِ ضبط GOOGLE_API_KEY.
أدلة ذات صلة
- free gemini api
- تجاوز حصة Gemini API (429 RESOURCE_EXHAUSTED)
- كيف تستخدم Claude Code مجاناً
- استخدام Codex CLI مع نماذج مجانية
- أفضل واجهات نماذج البرمجة المجانية
المصادر
- 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)