OpenCode کو CheapTokens سے کیسے جوڑیں (opencode.json)

OpenCode کو CheapTokens سے جوڑنے کے لیے، ایک حسبِ ضرورت OpenAI-مطابق provider شامل کریں: اپنی API key /connect کے ساتھ محفوظ کریں (provider ID cheaptokens)، پھر opencode.json میں provider کو base URL https://api.cheaptokens.dev/v1 کے ساتھ بیان کریں۔ اس کے بعد آپ کے CheapTokens ماڈلز /models میں ظاہر ہوں گے۔

یہ گائیڈ OpenCode کی providers دستاویزات کی پیروی کرتی ہے (صفحہ 20 اکتوبر 2026 کو اپ ڈیٹ ہوا؛ 22 اکتوبر 2026 کو چیک کیا گیا)۔ یہی طریقہ اس سلسلے کے دیگر ٹولز کے لیے بھی کام کرتا ہے: Cline، Aider اور Kilo Code۔

آپ کو کیا درکار ہے#

• OpenCode انسٹال شدہ (اپنے پلیٹ فارم کے لیے اس کی دستاویزات دیکھیں)۔
• ایک CheapTokens API key۔ اپنے اکاؤنٹ میں ایک بنائیں اور بیلنس ٹاپ اپ کریں؛ ایک بیلنس تمام ماڈلز کا احاطہ کرتا ہے۔ بنیادی باتیں CheapTokens دستاویزات میں ہیں۔
• API کی تفصیلات:
  • base URL: https://api.cheaptokens.dev/v1
  • مطابقت: OpenAI Chat Completions اور Anthropic Messages
  • نیچے استعمال شدہ model id: deepseek-ai/DeepSeek-V4-Flash-0731 (380K context، زیادہ سے زیادہ 32,768 output tokens)۔ Model ids CheapTokens دستاویزات میں درج ہیں: نام providers کے درمیان مختلف ہوتے ہیں، لہٰذا id وہاں سے کاپی کریں۔

مرحلہ 1۔ /connect کے ساتھ key محفوظ کریں#

1. اپنے پروجیکٹ میں OpenCode شروع کریں اور /connect چلائیں۔
2. Other تک اسکرول کریں۔
3. ایک منفرد provider ID درج کریں: cheaptokens۔
4. اپنی CheapTokens API key پیسٹ کریں۔

یہ مرحلہ صرف credential محفوظ کرتا ہے۔ OpenCode کو ابھی بھی provider کا پتہ یا ماڈلز معلوم نہیں: یہی opencode.json کا مقصد ہے۔

مرحلہ 2۔ opencode.json میں provider بیان کریں#

opencode.json بنائیں یا اس میں ترمیم کریں اور provider شامل کریں۔ provider میں provider ID کو /connect میں درج کردہ ID سے مماثل ہونا چاہیے۔

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

ہر حصہ کیا کرتا ہے:

• npm — @ai-sdk/openai-compatible ان endpoints کے لیے پیکیج ہے جو /v1/chat/completions استعمال کرتے ہیں، جو CheapTokens expose کرتا ہے۔ (OpenCode @ai-sdk/openai استعمال کرتا ہے ان endpoints کے لیے جو /v1/responses پر بنے ہیں۔)
• name — OpenCode انٹرفیس میں دکھایا جانے والا لیبل۔
• options.baseURL — CheapTokens API کا پتہ۔
• models — model id کے ذریعے keyed؛ اندر کا name ایک display name ہے۔
• limit.context / limit.output — اختیاری؛ وہ OpenCode کو ماڈل کا context window اور زیادہ سے زیادہ جواب کی لمبائی بتاتے ہیں۔

key کو بجائے اس کے environment variable میں رکھیں (اختیاری)#

اگر آپ key کو OpenCode کے credential store میں نہ رکھنا پسند کرتے ہیں، تو apiKey کو options میں {env:VARIABLE} syntax کے ساتھ شامل کریں جس کی دستاویزات تجویز کرتی ہیں:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

پھر اپنے shell میں CHEAPTOKENS_API_KEY export کریں۔ repository میں حقیقی key commit نہ کریں۔ اگر آپ keys میں نئے ہیں، تو API key کیا ہے اور اسے محفوظ طریقے سے کیسے محفوظ کریں پڑھیں۔

مرحلہ 3۔ چیک کریں کہ یہ کام کرتا ہے#

/models چلائیں اور CheapTokens provider کے تحت DeepSeek-V4-Flash منتخب کریں۔ پھر ایک مختصر prompt بھیجیں، مثلاً: "Summarize what this repository does in three sentences." ایک معمول کا جواب اس بات کا مطلب ہے کہ base URL، key اور model id سب درست ہیں۔

کون سا CheapTokens ماڈل منتخب کریں#

models میں جتنے چاہیں entries شامل کریں — ہر ایک اوپر والے جیسا بلاک ہے، اپنی id کے ساتھ۔

OpenCode سیشن کے لیے، جو loop میں بہت سی requests بھیجتا ہے، DeepSeek-V4-Flash ایک اچھا default ہے: output OpenRouter کی reference قیمت سے سستا ہے، جوابات 32,768 tokens تک پہنچ سکتے ہیں، اور قیمت میں peak hours نہیں ہیں۔ MiniMax-M2.7 بھی input اور output دونوں پر OpenRouter کی reference قیمتوں سے سستا ہے۔ GLM-5.3-Flash کا output بھی OpenRouter کی reference قیمت سے سستا ہے۔ موجودہ قیمتیں (live چیک شدہ، کوئی پرانے ہونے والے نمبر نہیں):

ایک working session کا تخمینہ لگانے کے لیے، مثلاً 20 requests جن میں ہر ایک میں 100,000 input اور 5,000 output tokens ہوں:

تمام قیمتیں اور DeepSeek صفحہ مزید کے لیے دیکھیں۔

اگر یہ کام نہ کرے#

• provider یا ماڈلز /models سے غائب ہیں۔ چیک کریں کہ opencode.json درست JSON ہے (کوئی trailing commas نہیں) اور provider کے تحت key بالکل وہی ID ہے جو آپ نے /connect میں درج کیا تھا۔ اگر دونوں درست ہیں، تو OpenCode دوبارہ شروع کریں۔
• 401 / authentication error۔ /connect دوبارہ چلائیں اور key دوبارہ پیسٹ کریں، یا shell میں CHEAPTOKENS_API_KEY variable چیک کریں جہاں OpenCode شروع ہوتا ہے۔
• 404 یا "model not found"۔ models میں model id کو CheapTokens id سے حرف بحرف مماثل ہونا چاہیے، بشمول vendor prefix (deepseek-ai/…)۔
• Connection errors۔ base URL کا اختتام /v1 پر ہونا چاہیے اور اس میں کوئی اضافی path نہیں ہونا چاہیے۔ عام connection errors دیکھیں۔
• "Not enough tokens"۔ بیلنس ٹاپ اپ کریں؛ error کا مطلب کیا ہے دیکھیں۔

اگلے مراحل#

اب آپ کے پاس OpenCode CheapTokens پر چل رہا ہے، تمام ماڈلز کے لیے ایک بیلنس کے ساتھ۔ ایک key حاصل کریں اور CheapTokens دستاویزات سے اپنی پہلی call کریں۔