OpenCode ফ্রি LLM API দিয়ে ব্যবহার করুন
OpenCode টার্মিনাল ও ডেস্কটপের জন্য একটি ওপেন-সোর্স কোডিং এজেন্ট। এটি যেকোনো OpenAI-সামঞ্জস্যপূর্ণ প্রোভাইডার গ্রহণ করে। এই গাইড OpenCode-কে FreeLLMAPI-এর মাধ্যমে ফ্রি মডেলের সাথে যুক্ত করে। একটি কমান্ড কনফিগ লেখে এবং কী সংরক্ষণ করে।
কোড, মডেলের নাম এবং লাইভ ক্যাটালগের লেবেল ইংরেজিতে দেখানো হয়।
ধাপ 1: FreeLLMAPI ইনস্টল করুন
FreeLLMAPI একটি ওপেন-সোর্স গেটওয়ে। এটি Docker-এ আপনার কম্পিউটারে চলে এবং 45টি প্রোভাইডারের ফ্রি টিয়ার একটি কী-এর পিছনে একত্র করে।
macOS বা Linux-এ ইনস্টল করুন
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001 খুলুন। Keys পেজে অন্তত দুটি ফ্রি প্রোভাইডার কী যোগ করুন। Google AI Studio ও Groq প্রত্যেকে কয়েক মিনিটে একটি ফ্রি কী দেয়। একই পেজ থেকে আপনার ইউনিফায়েড কী কপি করুন।
ধাপ 2: একটি কমান্ড দিয়ে OpenCode যুক্ত করুন
একটি কমান্ড
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeকমান্ডটি তিনটি কাজ করে:
- এটি একটি
freellmapiপ্রোভাইডার~/.config/opencode/opencode.json-এ যোগ করে। প্রোভাইডার আপনার লাইভ ক্যাটালগের মডেলগুলো তাদের কনটেক্সট সীমাসহ তালিকাভুক্ত করে। - এটি
freellmapi/auto-কে ডিফল্ট মডেল হিসেবে সেট করে। - এটি কীটি OpenCode-এর ক্রেডেনশিয়াল ফাইলে,
~/.local/share/opencode/auth.json-এ সংরক্ষণ করে। CLI বা ডেস্কটপ অ্যাপ, কোথাও আপনার environment variable লাগে না।
কমান্ড লেখার আগে একটি ব্যাকআপ নেয়। এটি নতুন প্রোভাইডার একত্র করে, তাই আপনার অন্য প্রোভাইডারগুলো থাকে। XDG_CONFIG_HOME বা XDG_DATA_HOME সেট থাকলে কমান্ড সেই ফোল্ডারগুলো ব্যবহার করে।
একটি দীর্ঘ টাস্ক শুরুর আগে নিশ্চিত করুন যে গেটওয়ে এখনই একটি অনুরোধ সার্ভ করতে পারে। এই কল শুধু সেই মডেলগুলো তালিকাভুক্ত করে, যাদের এই মুহূর্তে ব্যবহারযোগ্য কী আছে:
কোন মডেলগুলো প্রস্তুত দেখুন
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"exhausted স্ট্যাটাসের মডেলের কী আছে, কিন্তু এখন সবগুলো সীমায় আছে। কুলডাউন শেষ হলে এই স্ট্যাটাস মুছে যায়। একটি ক্লায়েন্টের অনুরোধ গেটওয়েতে পৌঁছায় কিনা নিশ্চিত করতে npx freellmapi doctor চালান। ড্যাশবোর্ডের রিকুয়েস্ট লগে OpenCode-এর প্রতিটি কল দেখায়। X-Routed-Via রেসপন্স হেডার প্রতিটি অনুরোধের উত্তর দেওয়া প্রোভাইডার ও মডেলের নাম দেয়। অনুরোধ ফেইলওভার হলে X-Fallback-Trail হেডার প্রতিটি ব্যর্থ ধাপ ও কারণ দেয়।
ম্যানুয়াল সেটআপ: opencode.json প্রোভাইডার ব্লক
ম্যানুয়ালি সেট আপ করতে ~/.config/opencode/opencode.json-এ, অথবা আপনার প্রজেক্টের opencode.json-এ এই ব্লকটি যোগ করুন। OpenCode @ai-sdk/openai-compatible ব্যবহার করে /v1/chat/completions এন্ডপয়েন্টের জন্য।
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}তারপর কী যোগ করুন। OpenCode শুরু করুন, /connect চালান, freellmapi প্রোভাইডার নির্বাচন করুন এবং আপনার ইউনিফায়েড কী পেস্ট করুন। /connect-এর প্রোভাইডার ID কনফিগের ID-এর সাথে মিলতে হবে। একটি মডেল নির্বাচন করতে /models চালান।
limit.contextহলো মডেলের সর্বোচ্চ ইনপুট টোকেন।limit.outputহলো সে যত টোকেন তৈরি করতে পারে তার সর্বোচ্চ সংখ্যা।- উপরের স্তরের
modelprovider/modelফরম্যাট ব্যবহার করে। এটি না থাকলে OpenCode আগে ব্যবহৃত মডেলটি রাখে। - আপনি যে প্রতিটি মডেল ID ব্যবহার করতে চান, তা
modelsম্যাপে থাকতে হবে।GET /v1/modelsথেকে আরও ID যোগ করুন।
providers কী আছে। ডকুমেন্ট বলে যে উপরের V1 ফরম্যাট এখনো সমর্থিত। FreeLLMAPI সেটআপ কমান্ড V1 ফরম্যাট লেখে।OpenCode-এর জন্য মডেল বাছুন
OpenCode একটি এজেন্ট। এটি টুল কলের মাধ্যমে ফাইল পড়ে, সম্পাদনা করে এবং কমান্ড চালায়। প্রতিটি অনুরোধে থাকে একটি সিস্টেম প্রম্পট, টুল সংজ্ঞা ও ফাইলের কন্টেন্ট। টুল কলিং ও বড় কনটেক্সট উইন্ডো সহ মডেল ব্যবহার করুন।
| মডেল | বিনামূল্যে | কনটেক্সট | বিনামূল্যের সীমা (সেরা অফার) | টুল | ভিশন |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 অনুরোধ/মিনিট 1 req/min per model | হ্যাঁ | না |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 অনুরোধ/মিনিট 40 RPM | হ্যাঁ | হ্যাঁ |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | হ্যাঁ | হ্যাঁ |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | হ্যাঁ | না |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | হ্যাঁ | হ্যাঁ |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 অনুরোধ/মিনিট 20 অনুরোধ/দিন 250,000 টোকেন/মিনিট ~3M | হ্যাঁ | হ্যাঁ |
| 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 | হ্যাঁ | হ্যাঁ |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 অনুরোধ/মিনিট 20 অনুরোধ/দিন 250,000 টোকেন/মিনিট ~3M | হ্যাঁ | হ্যাঁ |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | হ্যাঁ | হ্যাঁ |
মিলে যাওয়া 109টি বিনামূল্যের মডেলের মধ্যে 12টি দেখানো হচ্ছে। সব মডেল দেখুন.
FreeLLMAPI ক্যাটালগের লাইভ ডেটা (সংস্করণ 2026.11.19, যাচাই: 2026-11-19)। বিনামূল্যের সীমা প্রায়ই বদলায়। ক্যাটালগ প্রতিদিন যাচাই করা হয়।
প্রতিটি অনুরোধে রাউটার যেন একটি মডেল বাছে, তার জন্য freellmapi/auto ব্যবহার করুন। বুদ্ধিমত্তা বা গতি অনুযায়ী অনুরোধ চালাতে auto:smart বা auto:fast-কে models ম্যাপে যোগ করুন। ড্যাশবোর্ডে তৈরি করার পরে একটি নামকরা প্রোফাইল, যেমন auto:coding, যোগ করতে পারেন।
রেট লিমিট ও দীর্ঘ সেশন
একটি এজেন্ট টাস্ক ডজন ডজন অনুরোধ পাঠাতে পারে। একটি একক ফ্রি টিয়ার দ্রুত একটি দীর্ঘ টাস্ক থামিয়ে দেয়। FreeLLMAPI প্রতিটি কীর অনুরোধ ও টোকেন গণনা করে। একটি প্রোভাইডার 429 ত্রুটি পাঠালে রাউটার অনুরোধটি চেইনের পরবর্তী মডেলে পাঠায় এবং সেশন চলতে থাকে।
- চার বা তার বেশি প্রোভাইডার থেকে কী যোগ করুন। আরও প্রোভাইডার দৈনিক বেশি অনুরোধ দেয়।
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchদিয়ে FreeLLMAPI-এর.env-এ context handoff চালু করুন। মডেল বদলালে পরবর্তী মডেল একটি ছোট নোট পায় যে সে একটি টাস্ক চালিয়ে যাচ্ছে।- Sticky session একটি কথোপকথনকে 30 মিনিট একই মডেলে রাখে। এতে এজেন্ট ধারাবাহিক থাকে।
- প্রতিটি টাস্কের জন্য নতুন সেশন শুরু করুন। ছোট কনটেক্সট প্রতি অনুরোধে কম টোকেন ব্যবহার করে।
সমস্যা সমাধান
| সমস্যা | কারণ | সমাধান |
|---|---|---|
| বৈধ কী সত্ত্বেও "Invalid API key" | কনফিগে একটি খালি apiKey /connect-এর কীকে ওভাররাইড করে | apiKey options থেকে সরান, অথবা setup-opencode আবার চালান |
| OpenCode নতুন প্রোভাইডার ব্যবহার করে না | উপরের স্তরের model সেট নেই | "model": "freellmapi/auto" সেট করুন |
| মডেল পাওয়া যায়নি | মডেল ID প্রোভাইডারের models ম্যাপে নেই | ID ম্যাপে যোগ করুন, অথবা setup-opencode আবার চালান |
{env:VAR} কী খালি | OpenCode একটি সেট না করা ভেরিয়েবলকে খালি স্ট্রিং দিয়ে বদলে দেয় | একই শেলে ভেরিয়েবল export করুন, অথবা /connect দিয়ে কী সংরক্ষণ করুন |
| টুল কল ব্যর্থ হয় | মডেলের টুল কলিং দুর্বল | উপরের টেবিল থেকে একটি মডেল বাছুন |
| N বার চেষ্টার পরে সব মডেল সীমায় (rate-limited) | সব কী সীমায় আছে | আরও প্রোভাইডারের কী যোগ করুন, অথবা কুলডাউন শেষ হওয়ার জন্য অপেক্ষা করুন |
সাধারণ প্রশ্ন
OpenCode কি বিনামূল্যে ব্যবহার করা যায়?
হ্যাঁ। OpenCode ওপেন সোর্স। এটিকে একটি OpenAI-সামঞ্জস্যপূর্ণ প্রোভাইডার হিসেবে FreeLLMAPI-এর সাথে যুক্ত করুন। গেটওয়ে প্রতিটি অনুরোধ ফ্রি প্রোভাইডার টিয়ারে পাঠায়, তাই ইনফারেন্সের খরচ $0।
OpenCode-এ কীভাবে একটি কাস্টম OpenAI-সামঞ্জস্যপূর্ণ প্রোভাইডার যোগ করব?
opencode.json-এ npm-কে @ai-sdk/openai-compatible-এ সেট করে, options.baseURL ও একটি models ম্যাপ সহ একটি প্রোভাইডার যোগ করুন। তারপর কী সংরক্ষণ করতে /connect এবং মডেল বাছতে /models চালান।
OpenCode-এর জন্য কোন ফ্রি মডেল সবচেয়ে ভালো?
টুল কলিং এবং অন্তত 128K কনটেক্সট সহ একটি মডেল ব্যবহার করুন। এই পেজের টেবিলে আজ এই দুটি নিয়মই মেনে চলে এমন শক্তিশালী ফ্রি মডেল দেখানো হয়েছে। একটি বাছতে রাউটারকে দিতে freellmapi/auto ব্যবহার করুন।
OpenCode API কী কোথায় সংরক্ষণ করে?
/connect দিয়ে যোগ করা কী ~/.local/share/opencode/auth.json-এ যায়। FreeLLMAPI সেটআপ কমান্ড কীটি সেখানে লেখে, তাই CLI ও ডেস্কটপ অ্যাপ দুটোই এটি খুঁজে পায়।
সম্পর্কিত গাইড
- বিনামূল্যের LLM API দিয়ে Aider ব্যবহার করুন
- Codex CLI-তে বিনামূল্যের মডেল ব্যবহার করুন
- Claude Code বিনামূল্যে কীভাবে ব্যবহার করবেন
- সেরা বিনামূল্যের কোডিং মডেল API
- ফ্রি OpenAI-সামঞ্জস্যপূর্ণ API বেস URL
উৎস
- OpenCode docs: providers (V1 config) (যাচাই: 20 November 2026)
- OpenCode docs: config (যাচাই: 20 November 2026)
- OpenCode docs: migrate from V1 (যাচাই: 20 November 2026)
- FreeLLMAPI CLI generators (যাচাই: 20 November 2026)
- FreeLLMAPI docs: context handoff (যাচাই: 20 November 2026)