ہوم / گائیڈز / کسٹم endpoint اور مفت ماڈلز کے ساتھ Gemini CLI

کسٹم endpoint اور مفت ماڈلز کے ساتھ Gemini CLI

Gemini CLI Google کا اوپن سورس کوڈنگ ایجنٹ ہے جو ٹرمینل میں چلتا ہے۔ یہ اپنی درخواستیں کسٹم بیس URL پر بھیج سکتا ہے۔ یہ گائیڈ Gemini CLI کو FreeLLMAPI کی طرف موڑتی ہے، جو /v1beta پر نیٹو Gemini API سروس کرتا ہے۔ اس کے بعد آپ کی درخواستیں آپ کے مفت فراہم کنندگان کے پول کو جاتی ہیں، جن میں مفت Gemini API کلیدیں بھی شامل ہو سکتی ہیں۔

کوڈ، ماڈل کے نام اور براہِ راست کیٹلاگ کے لیبل انگریزی میں دکھائے جاتے ہیں۔

Gemini CLI کے مفت ٹائر میں 2026 کی تبدیلی

پہلے یہ پڑھیں۔ Google نے 2026 میں Gemini CLI کے مفت استعمال کو بدل دیا۔ Gemini CLI کوٹہ صفحے پر لکھا ہے: “مفت ٹائر اور Google One صارفین: Gemini CLI کی جگہ 18 جون 2026 کو Antigravity CLI نے لے لی۔”

Google کے اعلان کے مطابق Gemini CLI ادا شدہ Gemini API کلیدوں اور انٹرپرائز صارفین کے لیے دستیاب رہتا ہے۔

  • مفت ٹائر پر Google لاگ ان: اب عام اکاؤنٹس کے لیے Gemini CLI کے ذریعے سروس نہیں ہوتا۔
  • کسٹم بیس URL والی Gemini API کلید: Gemini CLI کا کنفیگریشن حوالہ اب بھی GOOGLE_GEMINI_BASE_URL کی دستاویز کرتا ہے۔ اس متغیر کے ساتھ Gemini CLI اپنی درخواستیں Google کے بجائے اس URL پر بھیجتا ہے جو آپ سیٹ کرتے ہیں۔
  • مفت 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 شروع کریں۔ بیس URL سرور کا origin ہے، /v1beta کے بغیر۔ API راستہ 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 کا ایک issue بتاتا ہے کہ ورژن 0.44.x میں جب GOOGLE_API_KEY کو GOOGLE_GEMINI_BASE_URL کے ساتھ استعمال کیا جائے تو "Invalid auth method selected" آتا ہے۔ اگر GOOGLE_API_KEY سیٹ ہو تو unset GOOGLE_API_KEY کے ساتھ اسے ہٹا دیں۔

مرحلہ 3: Gemini ماڈل کے ناموں کو مفت ماڈلز سے مربوط کریں

Gemini CLI Gemini ماڈل کے نام مانگتا ہے، مثلاً gemini-2.5-flash۔ FreeLLMAPI یہ نام براہِ راست Google کو نہیں بھیجتا۔ یہ انہیں Keys, Agents ٹیب پر موجود Gemini خاندان کے نقشے کے ذریعے حل کرتا ہے۔ ہر خاندان (Pro، Flash اور Flash-Lite) کو Auto سے یا کیٹلاگ کے کسی مقررہ ماڈل سے مربوط کریں۔

  • Auto کے ساتھ راؤٹر ہر درخواست کے لیے ایک مفت ماڈل منتخب کرتا ہے۔ جب کوئی فراہم کنندہ 429 خرابی بھیجے تو یہ اگلے کو آزماتا ہے۔
  • کیٹلاگ IDs بھی ماڈل کے ناموں کے طور پر کام کرتی ہیں۔ 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
ہاںہاں

14 میں سے 8 مماثل مفت ماڈلز دکھائے جا رہے ہیں۔ تمام ماڈلز دیکھیں.

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
ہاںہاں

104 میں سے 8 مماثل مفت ماڈلز دکھائے جا رہے ہیں۔ تمام ماڈلز دیکھیں.

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 ٹوکن کے طور پر، یا Gemini کے ?key= کیوری پیرامیٹر میں قبول کرتا ہے۔ ہیڈر کو ترجیح دیں، کیونکہ URL میں کلید shell history اور proxy logs میں لیک ہو سکتی ہے۔

خرابیوں کا ازالہ

مسئلہوجہحل
Gemini CLI Google لاگ ان کھولتا ہےتوثیق کی قسم Gemini API key پر سیٹ نہیں ہےUse Gemini API key منتخب کریں، یا security.auth.selectedType سیٹ کریں
"Invalid auth method selected" کا پیغامGOOGLE_API_KEY کسٹم بیس URL کے ساتھ استعمال ہو رہی ہےGEMINI_API_KEY استعمال کریں اور GOOGLE_API_KEY کو unset کریں
درخواستیں گیٹ وے کے بجائے Google کو جا رہی ہیںاس shell میں GOOGLE_GEMINI_BASE_URL سیٹ نہیں ہےمتغیر export کریں، پھر gemini دوبارہ شروع کریں
ماڈل کی کالز پر 404بیس URL میں /v1beta شامل ہےصرف origin http://localhost:3001 استعمال کریں
ٹول کالز ناکامGemini خاندان ایک ایسے ماڈل سے مربوط ہے جس میں ٹول کالنگ کمزور ہےخاندان کو اوپر کی جدولوں کے ماڈل سے مربوط کریں
N کوششوں کے بعد تمام ماڈلز ریٹ لمٹ ہو گئے ("ریٹ لمٹ" کا پیغام)تمام کلیدیں اپنی حد پر ہیںمزید فراہم کنندگان کی کلیدیں شامل کریں، یا کول ڈاؤن کا انتظار کریں
ان سب کو ایک ہی کلید سے استعمال کریں۔ FreeLLMAPI ایک اوپن سورس، خود میزبانی والا راؤٹر ہے۔ یہ ان تمام مفت ٹائرز کو ایک ہی OpenAI سے ہم آہنگ اینڈ پوائنٹ کے پیچھے رکھتا ہے، اور جب کوئی ایک ریٹ لمٹ ہو جائے تو خودکار طور پر دوسرے پر منتقل ہو جاتا ہے۔ کیٹلاگ دیکھیں یا لائیو جائیں.

اکثر پوچھے گئے سوالات

کیا Gemini CLI اب بھی مفت ہے؟

Google نے 18 جون 2026 کو غیر ادا شدہ اور Google One صارفین کے لیے Google لاگ ان کے ساتھ مفت Gemini CLI استعمال ختم کر دیا۔ CLI اب بھی کسٹم بیس URL سپورٹ کرتا ہے، اس لیے یہ FreeLLMAPI جیسے مفت گیٹ وے پر چل سکتا ہے۔

کسٹم endpoint کے ساتھ Gemini CLI کیسے استعمال کروں؟

GOOGLE_GEMINI_BASE_URL کو endpoint کے origin پر، اور GEMINI_API_KEY کو اس کی کلید پر سیٹ کریں، پھر Use Gemini API key منتخب کریں۔ endpoint کو /v1beta پر نیٹو Gemini API سپورٹ کرنی چاہیے۔

کیا Gemini CLI ایسے ماڈلز استعمال کر سکتا ہے جو Gemini نہیں ہیں؟

ہاں، FreeLLMAPI کے ذریعے۔ گیٹ وے Gemini Pro، Flash اور Flash-Lite کے خاندان کے ناموں کو Auto سے یا کسی بھی کیٹلاگ ماڈل سے مربوط کرتا ہے، مثلاً Qwen یا GLM ماڈل۔

Gemini API کے مفت ٹائر کی حدیں کیا ہیں؟

Google حدیں فی کلید نہیں بلکہ فی پروجیکٹ طے کرتا ہے، اور موجودہ قیمتیں Google AI Studio میں دکھاتا ہے۔ اس صفحے کی جدول FreeLLMAPI کیٹلاگ سے آج کے مفت Gemini ماڈلز اور ان کی حدیں دکھاتی ہے۔

مجھے 'Invalid auth method selected' کیوں ملتا ہے؟

Gemini CLI کا ایک issue یہ خرابی ورژن 0.44.x میں بتاتا ہے، جب GOOGLE_API_KEY کو GOOGLE_GEMINI_BASE_URL کے ساتھ استعمال کیا جائے۔ GEMINI_API_KEY استعمال کریں اور GOOGLE_API_KEY کو unset کریں۔

متعلقہ گائیڈز

ماخذ

تمام گائیڈز · تمام مفت ماڈلز دیکھیں