কাস্টম endpoint ও বিনামূল্যের মডেলসহ Gemini CLI
Gemini CLI হলো Google-এর ওপেন-সোর্স টার্মিনাল কোডিং এজেন্ট। এটি তার অনুরোধ একটি কাস্টম base URL-এ পাঠাতে পারে। এই গাইড Gemini CLI-কে FreeLLMAPI-র দিকে নির্দেশ করে, যা /v1beta-এ নেটিভ Gemini API সরবরাহ করে। তখন আপনার অনুরোধ যায় বিনামূল্যের প্রোভাইডারের পুলে, যার মধ্যে বিনামূল্যের Gemini API কীও থাকতে পারে।
কোড, মডেলের নাম এবং লাইভ ক্যাটালগের লেবেল ইংরেজিতে দেখানো হয়।
Gemini CLI-র বিনামূল্যের টিয়ারে 2026-এর পরিবর্তন
প্রথমে এটি পড়ুন। 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 দ্বারা সেবা দেওয়া হয় না।
- কাস্টম base URL সহ Gemini API কী: Gemini CLI-র কনফিগারেশন রেফারেন্সে এখনও
GOOGLE_GEMINI_BASE_URLলেখা আছে। এই variable দিলে 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-কে গেটওয়ের দিকে নির্দেশ করুন
দুটি environment variable সেট করুন এবং Gemini CLI চালু করুন। base 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>"
geminiGemini CLI যখন একটি authentication পদ্ধতি চায়, তখন Use Gemini API key বেছে নিন। পছন্দটি সংরক্ষণ করতে ~/.gemini/settings.json-এ সেট করুন:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY ব্যবহার করুন। একটি Gemini CLI issue জানায়, GOOGLE_API_KEY-কে GOOGLE_GEMINI_BASE_URL-এর সাথে ব্যবহার করলে সংস্করণ 0.44.x "Invalid auth method selected" দিয়ে ব্যর্থ হয়। GOOGLE_API_KEY সেট থাকলে unset GOOGLE_API_KEY দিয়ে তা সরিয়ে দিন।ধাপ 3: Gemini মডেলের নামগুলো বিনামূল্যের মডেলে ম্যাপ করুন
Gemini CLI gemini-2.5-flash-এর মতো Gemini মডেলের নাম চায়। FreeLLMAPI এই নামগুলো সরাসরি Google-এ পাঠায় না। এটি Keys, Agents ট্যাবের Gemini family ম্যাপের মাধ্যমে এগুলো সমাধান করে। প্রতিটি family (Pro, Flash ও Flash-Lite) Auto-তে বা একটি নির্দিষ্ট ক্যাটালগ মডেলে ম্যাপ করুন।
- Auto থাকলে রাউটার প্রতিটি অনুরোধের জন্য একটি বিনামূল্যের মডেল বেছে নেয়। একটি প্রোভাইডার 429 ত্রুটি পাঠালে এটি পরেরটি চেষ্টা করে।
- ক্যাটালগ ID-ও মডেলের নাম হিসেবে কাজ করে।
gemini -m <catalog-id>দিয়ে Gemini CLI চালু করুন, অথবাGEMINI_MODELসেট করুন। - Gemini CLI টুলসহ একটি এজেন্ট। family গুলোকে এমন মডেলে ম্যাপ করুন যেগুলো টুল কলিং এবং বড় কনটেক্সট উইন্ডো সমর্থন করে।
প্রথম টেবিলে আজ ক্যাটালগের বিনামূল্যের Gemini মডেলগুলো দেখানো হয়েছে। দ্বিতীয় টেবিলে অন্য বিনামূল্যের মডেলগুলো দেখানো হয়েছে, যেগুলো আপনি একটি Gemini family-তে ম্যাপ করতে পারেন।
| মডেল | বিনামূল্যে | কনটেক্সট | বিনামূল্যের সীমা (সেরা অফার) | টুল | ভিশন |
|---|---|---|---|---|---|
| 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-তে আপনার বর্তমান সীমা দেখতে পারেন। Preview মডেলের সীমা কম।
একটি বিনামূল্যের Gemini Flash কী দৈনিক কয়েকটি অনুরোধ দেয়। একটি Gemini CLI কাজ অনেক অনুরোধ পাঠাতে পারে। অন্য প্রোভাইডারের কী যোগ করুন, যাতে Gemini কোটা শেষ হলে রাউটার চালিয়ে যেতে পারে। নেটিভ surface generateContent, streamGenerateContent (?alt=sse সহ), countTokens এবং মডেল তালিকা সমর্থন করে।
FreeLLMAPI কীটি x-goog-api-key header-এ, Bearer টোকেন হিসেবে, অথবা Gemini-র ?key= query parameter-এ গ্রহণ করে। header পছন্দ করুন, কারণ URL-এর কী shell history ও proxy log-এ ফাঁস হতে পারে।
সমস্যা সমাধান
| সমস্যা | কারণ | সমাধান |
|---|---|---|
| Gemini CLI একটি Google লগইন খোলে | auth ধরন Gemini API key-তে সেট নেই | Use Gemini API key বেছে নিন, অথবা security.auth.selectedType সেট করুন |
| "Invalid auth method selected" | কাস্টম base URL-এর সাথে GOOGLE_API_KEY ব্যবহার হচ্ছে | GEMINI_API_KEY ব্যবহার করুন এবং GOOGLE_API_KEY unset করুন |
| অনুরোধ গেটওয়ের বদলে Google-এ যায় | এই shell-এ GOOGLE_GEMINI_BASE_URL সেট নেই | variable export করুন, তারপর gemini আবার চালু করুন |
মডেল কলে 404 | base URL-এ /v1beta আছে | শুধু origin http://localhost:3001 ব্যবহার করুন |
| টুল কল ব্যর্থ হয় | Gemini family এমন একটি মডেলে ম্যাপ করা যার টুল কলিং দুর্বল | উপরের টেবিলের একটি মডেলে family ম্যাপ করুন |
| "N বার চেষ্টার পর সব মডেল রেট-সীমাবদ্ধ" | সব কী সীমায় পৌঁছেছে | আরও প্রোভাইডার থেকে কী যোগ করুন, অথবা কুলডাউন শেষ হওয়ার জন্য অপেক্ষা করুন |
সাধারণ প্রশ্ন
Gemini CLI কি এখনও বিনামূল্যে?
Google 18 জুন 2026 থেকে অপেইড ও Google One ব্যবহারকারীদের জন্য Google লগইনসহ বিনামূল্যের Gemini CLI ব্যবহার বন্ধ করেছে। CLI এখনও কাস্টম base 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 family নামগুলো Auto-তে বা যেকোনো ক্যাটালগ মডেলে ম্যাপ করে, যেমন একটি Qwen বা GLM মডেল।
Gemini API-র বিনামূল্যের টিয়ারের সীমা কত?
Google সীমা প্রতি প্রকল্পে নির্ধারণ করে, প্রতি কীতে নয়, এবং বর্তমান মান Google AI Studio-তে দেখায়। এই পেজের টেবিলে FreeLLMAPI ক্যাটালগ থেকে আজকের বিনামূল্যের Gemini মডেল ও তাদের সীমা দেখানো হয়েছে।
কেন আমি 'Invalid auth method selected' পাই?
একটি Gemini CLI issue জানায়, GOOGLE_API_KEY-কে GOOGLE_GEMINI_BASE_URL-এর সাথে ব্যবহার করলে সংস্করণ 0.44.x-এ এই ত্রুটি আসে। GEMINI_API_KEY ব্যবহার করুন এবং GOOGLE_API_KEY unset করুন।
সম্পর্কিত গাইড
- free gemini api
- Gemini API কোটা শেষ (429 RESOURCE_EXHAUSTED)
- Claude Code বিনামূল্যে কীভাবে ব্যবহার করবেন
- Codex CLI-তে বিনামূল্যের মডেল ব্যবহার করুন
- সেরা বিনামূল্যের কোডিং মডেল API
উৎস
- 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)