OpenCode کو مفت LLM API کے ساتھ استعمال کریں
OpenCode ٹرمینل اور ڈیسک ٹاپ کے لیے ایک اوپن سورس کوڈنگ ایجنٹ ہے۔ یہ کسی بھی OpenAI سے مطابقت رکھنے والے provider کو قبول کرتا ہے۔ یہ گائیڈ OpenCode کو FreeLLMAPI کے ذریعے مفت ماڈلز سے جوڑتی ہے۔ ایک کمانڈ config لکھتی ہے اور کلید محفوظ کرتی ہے۔
کوڈ، ماڈل کے نام اور براہِ راست کیٹلاگ کے لیبل انگریزی میں دکھائے جاتے ہیں۔
مرحلہ 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یہ کمانڈ تین کام کرتی ہے:
- یہ ایک
freellmapiprovider کو~/.config/opencode/opencode.jsonمیں شامل کرتی ہے۔ provider آپ کی لائیو کیٹلاگ کے ماڈلز ان کی context حدوں کے ساتھ درج کرتا ہے۔ - یہ
freellmapi/autoکو ڈیفالٹ ماڈل کے طور پر سیٹ کرتی ہے۔ - یہ کلید OpenCode کی credential فائل
~/.local/share/opencode/auth.jsonمیں محفوظ کرتی ہے۔ CLI میں یا ڈیسک ٹاپ ایپ میں، آپ کو environment variable کی ضرورت نہیں۔
کمانڈ لکھنے سے پہلے بیک اپ بناتی ہے۔ یہ نیا provider ملاتی ہے، اس لیے آپ کے دوسرے providers برقرار رہتے ہیں۔ اگر XDG_CONFIG_HOME یا XDG_DATA_HOME سیٹ ہوں، تو کمانڈ انہی فولڈرز کو استعمال کرتی ہے۔
کوئی لمبا کام شروع کرنے سے پہلے یقینی بنائیں کہ گیٹ وے اب درخواست پوری کر سکتا ہے۔ یہ کال صرف وہی ماڈل دکھاتی ہے جن کی اس وقت قابلِ استعمال کلید ہے:
دیکھیں کون سے ماڈل تیار ہیں
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"جس ماڈل کی حیثیت exhausted ہو، اس کی کلیدیں ہیں، لیکن وہ سب اس وقت اپنی حد پر ہیں۔ یہ حیثیت cooldowns ختم ہونے پر صاف ہو جاتی ہے۔ یقینی بنانے کے لیے کہ کلائنٹ کی درخواستیں گیٹ وے تک پہنچتی ہیں، npx freellmapi doctor چلائیں۔ ڈیش بورڈ کا request log OpenCode کی ہر کال دکھاتا ہے۔ X-Routed-Via ردعمل کا ہیڈر اس فراہم کنندہ اور ماڈل کا نام دیتا ہے جس نے ہر درخواست کا جواب دیا۔ اگر درخواست fail over ہوئی، تو X-Fallback-Trail ہیڈر ہر ناکام قدم اور وجہ دیتا ہے۔
دستی ترتیب: opencode.json provider block
دستی طور پر ترتیب دینے کے لیے یہ block ~/.config/opencode/opencode.json میں شامل کریں، یا اپنے پروجیکٹ کی opencode.json میں۔ OpenCode @ai-sdk/openai-compatible استعمال کرتا ہے، /v1/chat/completions endpoints کے لیے۔
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 provider منتخب کریں اور اپنی متحدہ کلید چسپاں کریں۔ /connect میں provider ID کو config کی ID سے میل کھانا چاہیے۔ ماڈل منتخب کرنے کے لیے /models چلائیں۔
limit.contextماڈل کے زیادہ سے زیادہ ان پٹ tokens ہیں۔limit.outputوہ زیادہ سے زیادہ tokens ہیں جو یہ بنا سکتا ہے۔- سب سے اوپر کا
modelprovider/modelفارمیٹ استعمال کرتا ہے۔ اس کے بغیر، OpenCode وہی ماڈل رکھتا ہے جو اس نے پہلے استعمال کیا تھا۔ - ہر model ID جو آپ استعمال کرنا چاہتے ہیں،
modelsmap میں ہونی چاہیے۔GET /v1/modelsسے مزید IDs شامل کریں۔
providers کلید والا V2 config فارمیٹ بیان کرتی ہیں۔ دستاویزات کہتی ہیں کہ اوپر کا V1 فارمیٹ اب بھی سپورٹ ہوتا ہے۔ FreeLLMAPI کی setup کمانڈ V1 فارمیٹ لکھتی ہے۔OpenCode کے لیے ماڈل چنیں
OpenCode ایک ایجنٹ ہے۔ یہ ٹول کالز کے ذریعے فائلیں پڑھتا ہے، ان میں ترمیم کرتا ہے اور کمانڈز چلاتا ہے۔ ہر درخواست میں system prompt، ٹول کی تعریفیں اور فائلوں کا مواد ہوتا ہے۔ ٹول کالنگ اور بڑی context window والے ماڈلز استعمال کریں۔
| ماڈل | مفت دستیاب | سیاق و سباق | مفت حدیں (بہترین پیشکش) | ٹولز | ویژن |
|---|---|---|---|---|---|
| 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 map میں شامل کریں۔ آپ ڈیش بورڈ پر بنانے کے بعد کوئی نامزد profile بھی شامل کر سکتے ہیں، مثلاً auto:coding۔
حدیں اور لمبے سیشن
ایک ایجنٹ کام درجنوں درخواستیں بھیج سکتا ہے۔ ایک مفت ٹائر لمبے کام کو جلد روک دیتا ہے۔ FreeLLMAPI ہر کلید کی درخواستیں اور tokens گنتا ہے۔ جب کوئی فراہم کنندہ 429 خرابی بھیجے، تو راؤٹر درخواست chain کے اگلے ماڈل کو بھیجتا ہے، اور سیشن جاری رہتا ہے۔
- چار یا زیادہ فراہم کنندگان کی کلیدیں شامل کریں۔ زیادہ فراہم کنندگان روزانہ زیادہ درخواستیں دیتے ہیں۔
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchسیٹ کر کے FreeLLMAPI کی.envمیں context handoff آن کریں۔ جب ماڈل بدلتا ہے، تو اگلے ماڈل کو ایک مختصر نوٹ ملتا ہے کہ وہ ایک کام جاری رکھ رہا ہے۔- Sticky sessions ایک گفتگو کو 30 منٹ تک ایک ماڈل پر رکھتے ہیں۔ اس سے ایجنٹ یکساں رہتا ہے۔
- ہر کام کے لیے نیا سیشن شروع کریں۔ چھوٹا context ہر درخواست پر کم tokens استعمال کرتا ہے۔
خرابیوں کا حل
| مسئلہ | وجہ | حل |
|---|---|---|
| درست کلید کے ساتھ "Invalid API key" | config میں خالی apiKey، /connect کی کلید کو اوور رائٹ کرتی ہے | apiKey کو options سے ہٹائیں، یا setup-opencode دوبارہ چلائیں |
| OpenCode نیا provider استعمال نہیں کرتا | سب سے اوپر کا model سیٹ نہیں ہے | "model": "freellmapi/auto" سیٹ کریں |
| ماڈل نہیں ملا | model ID provider کے models map میں نہیں ہے | ID کو map میں شامل کریں، یا setup-opencode دوبارہ چلائیں |
{env:VAR} کلید خالی ہے | OpenCode غیر سیٹ variable کو خالی string سے بدل دیتا ہے | variable کو اسی shell میں export کریں، یا /connect سے کلید محفوظ کریں |
| ٹول کالز ناکام ہوتی ہیں | ماڈل میں ٹول کالنگ کمزور ہے | اوپر کے جدول سے ایک ماڈل منتخب کریں |
| "تمام ماڈلز N کوششوں کے بعد rate-limited" | تمام کلیدیں اپنی حد پر ہیں | مزید فراہم کنندگان کی کلیدیں شامل کریں، یا cooldowns کا انتظار کریں |
اکثر پوچھے گئے سوالات
کیا میں OpenCode مفت میں استعمال کر سکتا ہوں؟
ہاں۔ OpenCode اوپن سورس ہے۔ اسے OpenAI سے مطابقت رکھنے والے provider کے طور پر FreeLLMAPI سے جوڑیں۔ گیٹ وے ہر درخواست مفت فراہم کنندہ ٹائرز کو بھیجتا ہے، اس لیے inference کی لاگت $0 ہے۔
میں OpenCode میں کسٹم OpenAI سے مطابقت رکھنے والا provider کیسے شامل کروں؟
opencode.json میں ایک provider شامل کریں جس کا npm @ai-sdk/openai-compatible ہو، options.baseURL ہو، اور ایک models map ہو۔ پھر کلید محفوظ کرنے کے لیے /connect اور ماڈل منتخب کرنے کے لیے /models چلائیں۔
OpenCode کے لیے کون سا مفت ماڈل بہترین ہے؟
ٹول کالنگ اور کم از کم 128K context والا ماڈل استعمال کریں۔ اس صفحے کا جدول آج کے سب سے مضبوط مفت ماڈل دکھاتا ہے جو دونوں شرائط پوری کرتے ہیں۔ راؤٹر کو ایک منتخب کرنے دینے کے لیے freellmapi/auto استعمال کریں۔
OpenCode API کلیدیں کہاں محفوظ کرتا ہے؟
/connect سے شامل کی گئی کلیدیں ~/.local/share/opencode/auth.json میں جاتی ہیں۔ FreeLLMAPI کی setup کمانڈ کلید وہیں لکھتی ہے، تاکہ CLI اور ڈیسک ٹاپ ایپ دونوں اسے پا سکیں۔
متعلقہ گائیڈز
- مفت LLM API کے ساتھ Aider استعمال کریں
- مفت ماڈلز کے ساتھ Codex CLI استعمال کریں
- Claude Code مفت میں کیسے استعمال کریں
- بہترین مفت coding model APIs
- مفت OpenAI سے مطابقت رکھنے والے API base URLs
ماخذ
- 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 کو جانچا گیا)