---
title: "إعداد مزوّد مخصّص متوافق مع OpenAI في opencode | BroadRouter"
description: "أضف BroadNet Inference إلى وكيل البرمجة opencode كمزوّد مخصّص متوافق مع OpenAI في opencode.jsonc، مع أسماء بديلة للنماذج وقدراتها وحدودها."
url: https://broadrouter.com/ar/guides/opencode-custom-provider/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/opencode-custom-provider/) (حُدّث في 2026-11-16).

# إضافة BroadNet Inference إلى opencode كمزوّد مخصّص

آخر تحديث 2026-11-16

في opencode.jsonc، أضف إدخالًا باسم broadnet تحت providers مع الحزمة @opencode/ai/providers/openai-compatible، وsettings.baseURL مضبوطًا على https://inference.broadnet.ai/v1، وenv مضبوطًا على BROADNET\_API\_KEY. اربط مفاتيح نماذج قصيرة بمعرّفات BroadNet عبر modelID، مثل broadnet/glm-5.3، ثم اختر النموذج بالأمر /models. وما زالت إعدادات V1 القديمة التي تستخدم npm @ai-sdk/openai-compatible وoptions.baseURL تعمل.

opencode وكيل برمجة مفتوح المصدر يعمل في الطرفية. والمزوّدون غير الموجودين في فهرسه المدمج يُضافون **كمزوّدين مخصّصين** في `opencode.jsonc`. ولأن BroadNet Inference يتعامل بصيغة إكمال المحادثات من OpenAI، فهو يستخدم حزمة التشغيل المتوافقة مع OpenAI في opencode. يتبع هذا الدليل وثائق opencode الحالية (V2).

## الإعداد

1.  **صدّر مفتاحك** في الطرفية التي تشغّل منها opencode:

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **أنشئ ملف الإعداد.** ضعه في مشروعك باسم `opencode.jsonc`، أو في `~/.config/opencode/opencode.jsonc` لاستخدامه في كل مكان.

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
```

3.  **شغّل opencode واختر النموذج** بالأمر `/models`. المرجع هو `broadnet/<map key>`، مثل `broadnet/glm-5.3`. ويرسل opencode قيمة `modelID` إلى BroadNet.

تُدمَج ملفات الإعداد. يطبّق opencode الملف العام أولًا، ثم ملفات المشروع التي يجدها صعودًا من المجلد الحالي (الأبعد أولًا)، ثم أي إعداد في `.opencode/`، لذا يمكن لملف المشروع أن يتجاوز المزوّد العام. أما إعداد النظام المُدار، إن كانت شركتك تستخدمه، فيتقدّم على الاثنين. احتفظ بالمفتاح في متغيرات البيئة لا في الملف، حتى يمكن إدخال الإعداد في نظام التحكم بالإصدارات.

## لماذا الأسماء البديلة

تحتوي معرّفات BroadNet أصلًا على شرطة مائلة (`broadnet/glm-5.3`). مفتاح الخريطة `models` هو ما يعرضه opencode ويختاره، و`modelID` هو ما يرسله. والمفاتيح القصيرة تُبقي المراجع سهلة القراءة.

اضبط `capabilities` و`limit` بنفسك. فمع نموذج خارج فهرسه، يفترض opencode دعم أدوات JSON، وإدخال النص والصور، وسياقًا من 200,000 رمز، و32,000 رمز للمخرجات. وتسمّي وثائقه هذه القيم افتراضات احتياطية لا قيمًا مكتشَفة. أما قيمة `output` البالغة 16000 أعلاه فهي اقتراحنا وليست حدًّا من BroadNet؛ فهي تترك مساحة للاستدلال المنطقي.

### إعدادات V1 الأقدم

ما زال opencode V2 يقرأ صيغة V1، لذا تظل كتلة موجودة مثل هذه تعمل:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}
```

في صيغة V2 الأصلية يصبح `provider` هو `providers`، و`npm` هو `package` (`aisdk:@ai-sdk/openai-compatible` إن أردت الإبقاء على حزمة AI SDK)، وينتقل `options.baseURL` و`options.apiKey` إلى `settings`. ويربط [دليل الانتقال من V1 في opencode](https://opencode.ai/docs/migrate-v1/) كل حقل بمقابله.

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

| المهمة | النموذج | ملاحظات |
| --- | --- | --- |
| البرمجة بالوكلاء مع الأدوات | [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) | الأدوات والمخرجات المنظَّمة مدرجة؛ سياق 1M |
| لقطات الشاشة، والعربية | [Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/) | أدوات وصور؛ سياق 262K |
| جلسات طوال اليوم بسعر ثابت | [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) | خطط غير محدودة؛ لا يدرج BroadNet الأدوات له |

يعتمد opencode على استدعاءات الأدوات. ولا تدرج وثائق BroadNet استدعاء الأدوات لنموذج DeepSeek V4.1 Flash، لذا يَسِمه الإعداد بأنه افتراض يجب اختباره. نفّذ مهمة حقيقية خلال ساعة من خطة الشهاب (Meteor) ($1) قبل أن تشتري شهرًا من خطة البدر (Full Moon) ($60).

## حل المشكلات

-   **401.** المفتاح في `BROADNET_API_KEY` خاطئ أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. تأكّد من ضبط المتغير في العملية التي تشغّل opencode.
-   **النموذج غير موجود أو مرفوض.** اختر مفتاح الخريطة (`broadnet/glm-5.3`)، وتأكّد من تطابق `modelID` مع معرّف BroadNet تمامًا. المراجع حساسة لحالة الأحرف. تحتاج النماذج المدفوعة إلى شحن الرصيد؛ فرصيد $5 لا يغطي إلا `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **إجابات فارغة.** ارفع `limit.output`. [لماذا تصل الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** تسمح مفاتيح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. وإعادات المحاولة تُحتسب أيضًا. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **وكلاء فرعيون على خطة.** تعالج كل [جلسة خطة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) طلبًا واحدًا في كل مرة، لذا تصطفّ الوكلاء الفرعية المتوازية في طابور ما لم تكن لكل منها جلسة خاصة.

## مصطلحات في هذا الدليل

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

## أسئلة شائعة

### لماذا لا يجد opencode نموذج BroadNet الخاص بي؟

يحلّ opencode المرجع بصيغة provider/مفتاح الخريطة، والمعرّفات حساسة لحالة الأحرف. مع الإعداد أدناه، اختر broadnet/glm-5.3، حيث glm-5.3 هو مفتاح الخريطة. أما قيمة modelID فهي فقط ما يُرسَل إلى BroadNet.

### يستخدم إعدادي provider وnpm مع @ai-sdk/openai-compatible. هل هذا خطأ؟

لا. هذه صيغة V1، ويقول دليل الانتقال في opencode إنها ما زالت مدعومة. وفي صيغة V2 الأصلية يصبح provider هو providers، وnpm هو package (aisdk:@ai-sdk/openai-compatible)، وoptions.baseURL هو settings.baseURL.

### لماذا تصل ردود opencode فارغة؟

أنفق النموذج ميزانية المخرجات على الاستدلال المنطقي. ارفع limit.output للنموذج. فالاستدلال المنطقي يُحتسب ضمن max\_tokens في BroadNet.

## أدلة ذات صلة

-   [استخدام Cline مع BroadNet Inference (مزوّد OpenAI Compatible)](https://broadrouter.com/ar/guides/cline-openai-compatible/)
-   [كيف تعمل خطط LLM API غير المحدودة مع الوكلاء](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [استخدام Vercel AI SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/vercel-ai-sdk-openai-compatible/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-opencode-custom-provider&utm_content=page-cta) ·

**المصادر**

-   [وثائق opencode، صفحة Providers (المزوّد المخصّص) (رُوجعت في 2026-11-14)](https://opencode.ai/docs/providers/)
-   [وثائق opencode، صفحة Models (الأسماء البديلة والقدرات والحدود) (رُوجعت في 2026-11-14)](https://opencode.ai/docs/models/)
-   [وثائق opencode، مواقع ملفات الإعداد (رُوجعت في 2026-11-14)](https://opencode.ai/docs/config/)
-   [وثائق opencode، الانتقال من V1 (رُوجعت في 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-opencode-custom-provider&utm_content=sources)
