کسٹم 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-clihttp://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>
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 کا ایک 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 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 | ہاں | ہاں |
14 میں سے 8 مماثل مفت ماڈلز دکھائے جا رہے ہیں۔ تمام ماڈلز دیکھیں.
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 | ہاں | ہاں |
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 کوششوں کے بعد تمام ماڈلز ریٹ لمٹ ہو گئے ("ریٹ لمٹ" کا پیغام) | تمام کلیدیں اپنی حد پر ہیں | مزید فراہم کنندگان کی کلیدیں شامل کریں، یا کول ڈاؤن کا انتظار کریں |
اکثر پوچھے گئے سوالات
کیا 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 کریں۔
متعلقہ گائیڈز
- free gemini api
- Gemini API کا کوٹہ ختم (429 RESOURCE_EXHAUSTED)
- Claude Code مفت میں کیسے استعمال کریں
- مفت ماڈلز کے ساتھ Codex CLI استعمال کریں
- بہترین مفت coding model APIs
ماخذ
- 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 کو جانچا گیا)