---
title: "إعداد مزوّد مخصّص متوافق مع OpenAI في Kilo Code | BroadRouter"
description: "اربط Kilo Code بـ BroadNet Inference كمزوّد مخصّص من نوع OpenAI Compatible، من نافذة VS Code أو kilo.json، مع معرّفات النماذج والحدود وخيارات الأدوات."
url: https://broadrouter.com/ar/guides/kilo-code-openai-compatible/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام Kilo Code مع BroadNet Inference (مزوّد OpenAI Compatible)

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

في Kilo Code، افتح Settings، واذهب إلى Providers وانقر Custom provider. اختر OpenAI Compatible في Provider API، واضبط Base URL على https://inference.broadnet.ai/v1، والصق مفتاح BroadNet، وأضف يدويًا معرّف نموذج مثل broadnet/glm-5.3. وفي kilo.json، استخدم npm @ai-sdk/openai-compatible مع options.baseURL، واضبط limit.context وlimit.output.

Kilo Code وكيل برمجة مفتوح المصدر يعمل في VS Code وفي الطرفية. ويمكن إضافة أي مزوّد يوفّر OpenAI Chat Completions API بوصفه **مزوّدًا مخصّصًا** (custom provider). وBroadNet Inference تقدّم هذه الصيغة على `https://inference.broadnet.ai/v1`. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل [توثيق Kilo للمزوّدين](https://kilo.ai/docs/ai-providers/openai-compatible) كما كان في 15 نوفمبر 2026.

## الإعداد في VS Code

1.  **احصل على مفتاح.** أنشئ مفتاح دفع حسب الاستخدام في لوحة تحكم BroadNet، أو استخدم مفتاح [خطة غير محدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/).
    
2.  افتح **Settings** (أيقونة الترس) واذهب إلى تبويب **Providers**.
    
3.  انتقل إلى الأسفل وانقر **Custom provider**.
    
4.  املأ النافذة:
    
    | الحقل | القيمة |
    | --- | --- |
    | Provider ID | `broadnet` |
    | Display name | BroadNet Inference |
    | Provider API | **OpenAI Compatible** |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API key | مفتاح BroadNet الخاص بك |
    | Models | أضف `broadnet/glm-5.3` يدويًا (انظر أدناه) |
    
5.  انقر **Submit**. يظهر النموذج في قائمة اختيار النماذج.
    
6.  **اختبر الإعداد.** ابدأ مهمة مثل “explain this file”. إن أجاب، فالاتصال يعمل.
    

يحاول Kilo ملء قائمة النماذج من `/v1/models` الخاص بنقطة النهاية. ويصف توثيق BroadNet هذا المسار بأنه بيانات وصفية للكتالوج مخصّصة لأدوات المراقبة، وحين تحققنا منه في 15 نوفمبر 2026 لم يُدرج إلا نموذجَي التفريغ الصوتي. اكتب معرّفات نماذج المحادثة بنفسك، ولا تختر نماذج التفريغ الصوتي.

## الإعداد في kilo.json (لواجهة CLI، أو لضبط الحدود وخيارات الأدوات)

نافذة Kilo لا تضبط حدود الرموز ولا استدعاء الأدوات، ويحيل توثيقه في ذلك إلى ملف الإعداد: `~/.config/kilo/kilo.json`، أو `./kilo.json` داخل المشروع.

```jsonc
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "broadnet/glm-5.3",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["BROADNET_API_KEY"],
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "id": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "id": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "tool_call": true,
          "reasoning": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "id": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        }
      }
    }
  }
}
```

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

-   قيمة `model` في المستوى الأعلى، `broadnet/glm-5.3`، هي اسم المزوّد مضافًا إليه مفتاح الخريطة (`glm-5.3`)، وليست معرّف BroadNet. أما الحقل `id` فهو معرّف النموذج الذي يرسله Kilo إلى BroadNet. ويقول توثيق Kilo إن `id` يأخذ قيمة مفتاح الخريطة افتراضيًا، لذا اضبطه كلما لم يكن المفتاح هو معرّف BroadNet الكامل، كما في المفاتيح القصيرة هنا.
-   اضبط دائمًا `limit.context` و`limit.output`. فبحسب توثيق Kilo، إن لم يطابق النموذج المخصّص أي نموذج في الكتالوج، صارت القيمتان 0، وهذا يعطّل الإدارة التلقائية للسياق. والقيمة 16,000 للمخرجات اقتراح منا؛ فهي تترك مساحة للاستدلال المنطقي.
-   تُرك `tool_call` خارج DeepSeek V4.1 Flash عن قصد: فتوثيق BroadNet لا يُدرج استدعاء الأدوات له. أضفه بعد أن تختبره.

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

| المهمة | النموذج | ملاحظات |
| --- | --- | --- |
| برمجة بالوكلاء مع الأدوات | [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 |

جرّب الخطة غير المحدودة بساعة من الشهاب (Meteor) ($1) قبل شهر من البدر (Full Moon) ($60).

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

-   **“Invalid API Key” أو 401.** الصق المفتاح من جديد. وتحقّق من أن للمفتاح رصيدًا متبقيًا، وأن `BROADNET_API_KEY` مضبوط في العملية التي تشغّل Kilo.
-   **“Model Not Found”.** تحقّق من أن المعرّف يطابق معرّف BroadNet تمامًا، مع البادئة `broadnet/`. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **إجابة فارغة أو رسالة “response may be incomplete”.** (ترجمة: قد تكون الاستجابة ناقصة.) ينبّه Kilo حين ينفق نموذج استدلالي كامل المخرجات على الاستدلال المنطقي. ارفع `limit.output`. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **الوكلاء الفرعيون المتوازيون على مفتاح خطة واحد ينتظرون أو يفشلون.** تشغّل جلسة الخطة طلبًا واحدًا في كل مرة، فأعطِ كل وكيل فرعي متوازٍ جلسته الخاصة.
-   **أخطاء الاتصال.** يجب أن ينتهي Base URL بـ `/v1`. وإن كان لمفتاحك [قائمة عناوين IP مسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/)، فأضف عنوان جهازك.

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

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

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

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

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

[الوكيل الفرعي (Subagent)](https://broadrouter.com/ar/glossary/subagent/)

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

[تحويل الصوت إلى نص (Speech-to-text)](https://broadrouter.com/ar/glossary/speech-to-text/)

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

[مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/)

مفتاح API هو سلسلة نصية سرية تعرّف العميل الذي يستدعي الواجهة وتخوّله. تتوقعه واجهات LLM API عادةً في الترويسة Authorization: Bearer، وكل من يملك المفتاح يستطيع إرسال طلبات تُحتسب تكلفتها على الحساب المالك له.

[Chat Completions API (واجهة إكمال المحادثة)](https://broadrouter.com/ar/glossary/chat-completions-api/)

Chat Completions API هي نقطة نهاية HTTP لدى OpenAI، أي POST /v1/chat/completions، تستقبل اسم نموذج وقائمة رسائل موسومة بأدوارها وتُرجع الرسالة التالية من النموذج. وصارت بنية طلبها واستجابتها الصيغة المشتركة التي يعيد استخدامها المزوّدون المتوافقون مع OpenAI وحزم SDK.

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

### لماذا لا يعرض Kilo Code نماذج المحادثة من BroadNet بعد إدخال Base URL؟

يجلب Kilo النماذج من قائمة /v1/models الخاصة بنقطة النهاية. وحين تحققنا في 15 نوفمبر 2026، لم يُدرج المسار العام /v1/models في BroadNet إلا نموذجَي التفريغ الصوتي، فأضف معرّفات نماذج المحادثة يدويًا.

### ما قيمة limit.context لنماذج BroadNet؟

1048576 لنموذجَي GLM 5.3 وDeepSeek V4.1 Flash، و262144 لنموذج Qwen3.8 27B، و32768 لنموذج BroadNet Gemma 4 VL 26B. ويقول توثيق Kilo إن غياب الحد يجعل قيمته 0 للنماذج المخصّصة، وهذا يعطّل الإدارة التلقائية للسياق.

### هل يمكن استخدام Kilo Code على الخطة غير المحدودة من BroadNet؟

نعم. تغطي الخطط نموذج DeepSeek V4.1 Flash بالمعرّف broadnet/deepseek-v4.1-flash. استخدم مفتاح الخطة مفتاحًا لـ API. ولا يُدرج توثيق BroadNet استدعاء الأدوات لهذا النموذج، فاختبر مهمة وكيل أولًا.

### هل أختار OpenAI Compatible أم OpenAI Responses في Provider API؟

اختر OpenAI Compatible. تقدّم BroadNet chat completions على /v1/chat/completions، ولا تُدرج Responses API.

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

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

**المصادر**

-   [توثيق Kilo Code، صفحة Using OpenAI-Compatible Providers (رُوجع في 2026-11-15)](https://kilo.ai/docs/ai-providers/openai-compatible)
-   [توثيق Kilo Code، صفحة Custom Models (الحقول id وtool\_call وlimit) (رُوجع في 2026-11-15)](https://kilo.ai/docs/code-with-ai/agents/custom-models)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-kilo-code-openai-compatible&utm_content=sources)
