---
title: "إعداد مزوّد متوافق مع OpenAI في Zed (GLM وQwen) | BroadRouter"
description: "أضف BroadNet Inference إلى محرر Zed كمزوّد متوافق مع OpenAI في settings.json، مع معرّفات النماذج وحدود الرموز والقدرات ومتغير المفتاح."
url: https://broadrouter.com/ar/guides/zed-openai-compatible-provider/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام Zed مع BroadNet Inference كمزوّد متوافق مع OpenAI

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

في ملف settings.json الخاص بـ Zed، أضف مزوّدًا تحت language\_models.openai\_compatible، مثل broadnet، واضبط api\_url على https://inference.broadnet.ai/v1، واذكر في available\_models معرّفات BroadNet مثل broadnet/glm-5.3 مع ضبط max\_tokens على حجم السياق. يقرأ Zed المفتاح من BROADNET\_API\_KEY، أو يمكنك حفظه في Agent Settings.

Zed محرر شيفرة مفتوح المصدر فيه وكيل مدمج. ويتصل بأي خادم يوفّر API متوافقة مع OpenAI عبر نوع المزوّد `openai_compatible`. وBroadNet Inference تقدّم chat completions القياسية على `https://inference.broadnet.ai/v1`، لذا فهي مناسبة له. BroadRouter هو موقع BroadNet نفسها؛ والخطوات أدناه تتبع [توثيق الوصول عبر الـ API في Zed](https://zed.dev/docs/ai/use-api-access#openai-compatible) كما هو في Zed 1.28.

## الإعداد

1.  **احصل على مفتاح.** أنشئ مفتاح دفع حسب الاستخدام في لوحة تحكم BroadNet، أو استخدم مفتاح [خطة غير محدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/).
2.  **أضف المزوّد.** إما أن تفتح Agent Settings بالأمر `agent: open settings` وتنقر **Add Provider** في قسم LLM Providers، وإما أن تعدّل `settings.json` مباشرة:

```json
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
```

3.  **أعطِ Zed المفتاح.** صدّره قبل تشغيل Zed، أو الصقه في المزوّد داخل Agent Settings. يخزّن Zed المفاتيح الملصوقة في سلسلة مفاتيح النظام (keychain)، لا في `settings.json`.

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

4.  **اختبره.** افتح Agent Panel، واختر **GLM 5.3 (BroadNet)** من قائمة النماذج، واطرح سؤالًا صغيرًا عن ملف مفتوح. إن وصلتك إجابة فالاتصال يعمل.

## معنى الإعدادات

-   **`name`** هو معرّف النموذج الذي يرسله Zed. استخدم معرّف BroadNet كما هو تمامًا، مع البادئة `broadnet/`.
-   **`max_tokens`** في مخطط Zed هو نافذة السياق، لا حد المخرجات. استخدم 1,048,576 لـ GLM 5.3 وDeepSeek V4.1 Flash، و262,144 لـ Qwen3.8 27B.
-   **`max_output_tokens`** يحدّ طول الرد. والقيمة 16,000 أعلاه اقتراح منّا، لا حد من BroadNet. والاستدلال يُحتسب ضمنها، فلا تضبطها على قيمة منخفضة.
-   **`max_tokens_parameter: true`** يجعل Zed يرسل حد المخرجات في `max_tokens` بدلًا من `max_completion_tokens`. ويصف المرجع التقني لـ BroadNet الحقل `max_tokens`.
-   **`images`** قيمته الافتراضية false في النماذج المتوافقة مع OpenAI. فعّله فقط للنماذج التي تقبل الصور: Qwen3.8 27B وDeepSeek V4.1 Flash وBroadNet Gemma 4 VL 26B.
-   **`reasoning_effort`** اختياري. ويقترح توثيق BroadNet القيمة `low` إن أردت تفكيرًا أقصر.

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

| الاستخدام | النموذج | السبب |
| --- | --- | --- |
| تعديلات الوكيل مع الأدوات | `broadnet/glm-5.3` | تُدرج BroadNet له الأدوات والمخرجات المهيكلة؛ سياق مليون رمز |
| لقطات الشاشة والنص العربي | `broadnet/qwen3.8-27b` | أدوات مع إدخال الصور؛ سياق 262K |
| محادثات طويلة على خطة بسعر ثابت | `broadnet/deepseek-v4.1-flash` | نموذج الخطة غير المحدودة؛ يقبل الصور؛ لا تُدرج BroadNet له الأدوات |

يفترض Zed القيمة `tools: true` للنماذج المتوافقة مع OpenAI. ولا يذكر توثيق BroadNet استدعاء الأدوات (tool calling) لـ DeepSeek V4.1 Flash، فاختبر مهمة وكيل حقيقية عليه قبل أن تعتمد عليه. وساعة من الشهاب (Meteor) بسعر $1 طريقة رخيصة لتجربته قبل شهر من البدر (Full Moon) بسعر $60.

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

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استُنفد رصيده. إن ضبطت `BROADNET_API_KEY` فهو يتقدّم على سلسلة المفاتيح؛ ألغِ ضبطه وأعد تشغيل Zed لاستخدام المفتاح المحفوظ بدلًا منه.
-   **404 على كل طلب.** تأكّد أن `api_url` ينتهي بـ `/v1`. ثم تأكّد أن `name` يطابق معرّف BroadNet تمامًا. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ فالرصيد المبدئي البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **ردود فارغة.** استهلك النموذج ميزانية مخرجاته في الاستدلال. ارفع `max_output_tokens` أو اضبط `reasoning_effort` على `low`. [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ في آن واحد. وجلسة الخطة تشغّل طلبًا واحدًا في كل مرة. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **المشاريع البعيدة (Remote projects).** يهيّئ Zed المزوّدين في التطبيق المحلي، لذا عند العمل عبر SSH يأتي المفتاح من سلسلة المفاتيح المحلية أو من بيئتك المحلية، لا من الجهاز البعيد.

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

[استدعاء الأدوات (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 حتى تكتمل استجابته.

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

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

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

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

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

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

[خطة LLM API بسعر ثابت (Flat-rate LLM plan)](https://broadrouter.com/ar/glossary/flat-rate-llm-plan/)

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

[نافذة السياق (Context window)](https://broadrouter.com/ar/glossary/context-window/)

نافذة السياق هي الحد الأقصى لعدد الرموز (التوكنات) التي يستطيع نموذج اللغة التعامل معها في طلب واحد. وتشمل الأمر (prompt) وسجل المحادثة وتعريفات الأدوات والصور والمخرجات المولَّدة، بما فيها رموز الاستدلال المنطقي. وكل ما لا يتسع لها يجب قصّه أو تلخيصه أو توزيعه على عدة طلبات.

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

### ما متغير البيئة الذي يقرأ منه Zed مفتاح المزوّد المخصّص؟

يبني Zed الاسم من معرّف المزوّد بصيغة upper snake case مع اللاحقة \_API\_KEY. فالمزوّد المسمّى broadnet يقرأ BROADNET\_API\_KEY. والمتغير غير الفارغ يتقدّم على المفتاح المحفوظ في سلسلة المفاتيح (keychain).

### هل يعمل نموذج BroadNet في Agent Panel في Zed؟

نعم. يغطي الوصول عبر الـ API في Zed كلًا من Zed Agent وInline Assistant ورسائل commit وملخصات المحادثات. ويفترض Zed دعم الأدوات في النماذج المتوافقة مع OpenAI، فاختر GLM 5.3 أو Qwen3.8 27B، وهما مُدرجان لدى BroadNet مع دعم الأدوات.

### هل يغيّر هذا ميزة edit predictions في Zed؟

لا. يقول توثيق Zed إن لـ edit prediction إعداد مزوّد خاصًا بها تحت edit\_predictions. والمزوّد في هذا الدليل مخصّص للوكيل ولميزات الذكاء الاصطناعي الأخرى في Zed.

### لماذا يقول Zed إن النموذج لا يعمل إلا مع Responses API؟

لا ينبغي أن يحدث ذلك مع BroadNet. اترك capabilities.chat\_completions على قيمتها الافتراضية true. فـ BroadNet تقدّم /v1/chat/completions ولا تذكر Responses API.

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

-   [استخدام Kilo Code مع BroadNet Inference (مزوّد OpenAI Compatible)](https://broadrouter.com/ar/guides/kilo-code-openai-compatible/)
-   [استخدام Cline مع BroadNet Inference (مزوّد OpenAI Compatible)](https://broadrouter.com/ar/guides/cline-openai-compatible/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع 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-zed-openai-compatible-provider&utm_content=page-cta) ·

**المصادر**

-   [توثيق Zed، Use API Access، نقاط النهاية المتوافقة مع OpenAI (رُوجع في 2026-11-15)](https://zed.dev/docs/ai/use-api-access#openai-compatible)
-   [إصدارات Zed على GitHub، أحدثها v1.28.1 (رُوجع في 2026-11-15)](https://github.com/zed-industries/zed/releases)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-zed-openai-compatible-provider&utm_content=sources)
