كيفية توصيل OpenCode بـ CheapTokens (opencode.json)

لتوصيل OpenCode بـ CheapTokens، أضف مزوّدًا مخصّصًا متوافقًا مع OpenAI: خزّن مفتاح API الخاص بك باستخدام /connect (معرّف المزوّد cheaptokens)، ثم عرّف المزوّد في opencode.json مع عنوان URL الأساسي https://api.cheaptokens.dev/v1. بعد ذلك تظهر نماذج CheapTokens الخاصة بك في /models.

يتبع هذا الدليل توثيق المزوّدين الخاص بـ OpenCode (تم تحديث الصفحة في 20 أكتوبر 2026؛ وتم التحقق منها في 22 أكتوبر 2026). ينطبق النهج نفسه على الأدوات الأخرى في هذه السلسلة: Cline، وAider، وKilo Code.

ما تحتاج إليه#

• OpenCode مثبّتًا (راجع توثيقه الخاص بمنصّتك).
• مفتاح API من CheapTokens. أنشئ واحدًا في حسابك واشحن الرصيد؛ رصيد واحد يغطي جميع النماذج. الأساسيات موجودة في توثيق CheapTokens.
• حقائق API:
  • عنوان URL الأساسي: https://api.cheaptokens.dev/v1
  • التوافق: OpenAI Chat Completions و Anthropic Messages
  • معرّف النموذج المستخدم أدناه: deepseek-ai/DeepSeek-V4-Flash-0731 (سياق 380K، وحتى 32,768 رمز إخراج). معرّفات النماذج مدرجة في توثيق CheapTokens: تختلف الأسماء بين المزوّدين، لذا انسخ المعرّف من هناك.

الخطوة 1. خزّن المفتاح باستخدام /connect#

1. شغّل OpenCode في مشروعك ونفّذ /connect.
2. مرّر إلى Other.
3. أدخل معرّف مزوّد فريدًا: cheaptokens.
4. الصق مفتاح API الخاص بـ CheapTokens.

هذه الخطوة تخزّن بيانات الاعتماد فقط. لا يزال OpenCode لا يعرف عنوان المزوّد ولا نماذجه: وهذا ما يخدمه opencode.json.

الخطوة 2. عرّف المزوّد في opencode.json#

أنشئ أو حرّر opencode.json وأضف المزوّد. يجب أن يطابق معرّف المزوّد في provider المعرّف الذي أدخلته في /connect.

{
  "$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 هي الحزمة الخاصة بنقاط النهاية التي تستخدم /v1/chat/completions، وهو ما يوفّره CheapTokens. (يستخدم OpenCode @ai-sdk/openai لنقاط النهاية المبنية على /v1/responses.)
• name — التسمية المعروضة في واجهة OpenCode.
• options.baseURL — عنوان API الخاص بـ CheapTokens.
• models — مفتاحه هو معرّف النموذج؛ وname بداخله هو اسم العرض.
• limit.context / limit.output — اختياريان؛ يخبران OpenCode بنافذة سياق النموذج والحد الأقصى لطول الإجابة.

احتفظ بالمفتاح في متغيّر بيئة بدلًا من ذلك (اختياري)#

إذا كنت تفضّل عدم الاحتفاظ بالمفتاح في مخزن بيانات الاعتماد الخاص بـ OpenCode، فأضف apiKey إلى options بصيغة {env:VARIABLE} التي يوصي بها التوثيق:

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

ثم صدّر CHEAPTOKENS_API_KEY في shell الخاص بك. لا ترفع مفتاحًا حقيقيًا إلى المستودع. إذا كنت جديدًا على المفاتيح، اقرأ ما هو مفتاح API وكيف تخزّنه بأمان.

الخطوة 3. تحقّق من أنه يعمل#

نفّذ /models واختر DeepSeek-V4-Flash ضمن مزوّد CheapTokens. ثم أرسل طلبًا قصيرًا، على سبيل المثال: "لخّص ما يفعله هذا المستودع في ثلاث جمل." الإجابة الطبيعية تعني أن عنوان URL الأساسي والمفتاح ومعرّف النموذج كلها صحيحة.

أي نموذج من CheapTokens تختار#

أضف ما تشاء من الإدخالات إلى models — كل إدخال هو كتلة مثل الكتلة أعلاه، بمعرّفه الخاص.

بالنسبة لجلسة OpenCode، التي ترسل طلبات كثيرة في حلقة، يُعدّ DeepSeek-V4-Flash خيارًا افتراضيًا جيدًا: الإخراج أرخص من سعر مرجع OpenRouter، ويمكن أن تصل الإجابات إلى 32,768 رمزًا، ولا يوجد لسعره ساعات ذروة. كما أن MiniMax-M2.7 أرخص من أسعار مرجع OpenRouter في كلٍّ من الإدخال والإخراج. وإخراج GLM-5.3-Flash أرخص أيضًا من سعر مرجع OpenRouter. الأسعار الحالية (يتم التحقق منها مباشرةً، بلا أرقام تتقادم):

لتقدير جلسة عمل، على سبيل المثال 20 طلبًا بمعدّل 100,000 رمز إدخال و5,000 رمز إخراج لكل طلب:

راجع جميع الأسعار وصفحة DeepSeek للمزيد.

إذا لم يعمل#

• المزوّد أو النماذج مفقودة من /models. تحقّق من أن opencode.json بصيغة JSON صحيحة (بلا فواصل زائدة) وأن المفتاح تحت provider هو بالضبط المعرّف الذي أدخلته في /connect. إذا كان كلاهما صحيحًا، فأعد تشغيل OpenCode.
• 401 / خطأ في المصادقة. أعد تشغيل /connect والصق المفتاح مرة أخرى، أو تحقّق من متغيّر CHEAPTOKENS_API_KEY في shell الذي يبدأ منه OpenCode.
• 404 أو "model not found". يجب أن يطابق معرّف النموذج في models معرّف CheapTokens حرفًا بحرف، بما في ذلك بادئة المورّد (deepseek-ai/…).
• أخطاء الاتصال. يجب أن ينتهي عنوان URL الأساسي بـ /v1 وألّا يحتوي على مسار إضافي. راجع أخطاء الاتصال الشائعة.
• "Not enough tokens". اشحن الرصيد؛ راجع معنى الخطأ.

الخطوات التالية#

أصبح لديك الآن OpenCode يعمل على CheapTokens برصيد واحد لجميع النماذج. احصل على مفتاح وقم بأول استدعاء من توثيق CheapTokens.