الرئيسية / الأدلة / Gemini CLI مع نقطة وصول مخصصة ونماذج مجانية

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>
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، أو في معامل الاستعلام ?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 محاولة"وصلت كل المفاتيح إلى حدهاأضف مفاتيح من مزوّدين آخرين، أو انتظر فترات التهدئة
استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

الأسئلة الشائعة

هل 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.

أدلة ذات صلة

المصادر

كل الأدلة · تصفح كل النماذج المجانية