ہوم / گائیڈز / OpenCode کو مفت LLM API کے ساتھ استعمال کریں

OpenCode کو مفت LLM API کے ساتھ استعمال کریں

OpenCode ٹرمینل اور ڈیسک ٹاپ کے لیے ایک اوپن سورس کوڈنگ ایجنٹ ہے۔ یہ کسی بھی OpenAI سے مطابقت رکھنے والے provider کو قبول کرتا ہے۔ یہ گائیڈ OpenCode کو FreeLLMAPI کے ذریعے مفت ماڈلز سے جوڑتی ہے۔ ایک کمانڈ config لکھتی ہے اور کلید محفوظ کرتی ہے۔

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

مرحلہ 1: FreeLLMAPI انسٹال کریں

FreeLLMAPI ایک اوپن سورس گیٹ وے ہے۔ یہ آپ کے کمپیوٹر پر Docker میں چلتا ہے اور 45 فراہم کنندگان کے مفت ٹائرز کو ایک کلید کے پیچھے جمع کرتا ہے۔

macOS یا Linux پر انسٹال کریں

curl -fsSL https://freellmapi.co/install.sh | bash

http://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 provider کو ~/.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 ہیں جو یہ بنا سکتا ہے۔
  • سب سے اوپر کا model provider/model فارمیٹ استعمال کرتا ہے۔ اس کے بغیر، OpenCode وہی ماڈل رکھتا ہے جو اس نے پہلے استعمال کیا تھا۔
  • ہر model ID جو آپ استعمال کرنا چاہتے ہیں، models map میں ہونی چاہیے۔ GET /v1/models سے مزید IDs شامل کریں۔
config ورژنز کا نوٹ: OpenCode کی دستاویزات اب providers کلید والا V2 config فارمیٹ بیان کرتی ہیں۔ دستاویزات کہتی ہیں کہ اوپر کا V1 فارمیٹ اب بھی سپورٹ ہوتا ہے۔ FreeLLMAPI کی setup کمانڈ V1 فارمیٹ لکھتی ہے۔

OpenCode کے لیے ماڈل چنیں

OpenCode ایک ایجنٹ ہے۔ یہ ٹول کالز کے ذریعے فائلیں پڑھتا ہے، ان میں ترمیم کرتا ہے اور کمانڈز چلاتا ہے۔ ہر درخواست میں system prompt، ٹول کی تعریفیں اور فائلوں کا مواد ہوتا ہے۔ ٹول کالنگ اور بڑی context window والے ماڈلز استعمال کریں۔

OpenCode کے لیے مفت ماڈلز: ٹول کالنگ اور 128K+ context
ماڈلمفت دستیابسیاق و سباقمفت حدیں (بہترین پیشکش)ٹولزویژن
GLM 5.3UnoRouter1M1 درخواستیں فی منٹ
1 req/min per model
ہاںنہیں
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 درخواستیں فی منٹ
40 RPM
ہاںہاں
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaہاںہاں
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceہاںنہیں
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditہاںہاں
Gemini 3.7 FlashGoogle AI Studio1M10 درخواستیں فی منٹ
20 درخواستیں فی دن
250,000 ٹوکن فی منٹ
~3M
ہاںہاں
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
ہاںہاں
Gemini 3.6 FlashGoogle AI Studio1M10 درخواستیں فی منٹ
20 درخواستیں فی دن
250,000 ٹوکن فی منٹ
~3M
ہاںہاں
Qwen 3.8 27BCloudflare Workers AI262KShared 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 کا انتظار کریں
ان سب کو ایک ہی کلید سے استعمال کریں۔ FreeLLMAPI ایک اوپن سورس، خود میزبانی والا راؤٹر ہے۔ یہ ان تمام مفت ٹائرز کو ایک ہی OpenAI سے ہم آہنگ اینڈ پوائنٹ کے پیچھے رکھتا ہے، اور جب کوئی ایک ریٹ لمٹ ہو جائے تو خودکار طور پر دوسرے پر منتقل ہو جاتا ہے۔ کیٹلاگ دیکھیں یا لائیو جائیں.

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

کیا میں 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 اور ڈیسک ٹاپ ایپ دونوں اسے پا سکیں۔

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

ماخذ

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