---
title: "مكوّن OpenAI في Langflow مع OpenAI API Base مخصّص | BroadRouter"
description: "استخدم BroadNet Inference في Langflow عبر حقل OpenAI API Base في مكوّن OpenAI واسم نموذج مكتوب يدويًا، ولماذا لا يُدرجه مزوّد OpenAI Compatible."
url: https://broadrouter.com/ar/guides/langflow-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/langflow-openai-compatible/) (حُدّث في 2026-11-16).

# ربط Langflow بـ BroadNet Inference (مكوّن OpenAI)

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

في Langflow، أضف مكوّن OpenAI من حزمة OpenAI. اكتب معرّفًا من BroadNet مثل broadnet/glm-5.3 في Model Name، والصق مفتاح BroadNet، ثم اضبط OpenAI API Base في الإعدادات المتقدمة على https://inference.broadnet.ai/v1. لا تستخدم مزوّد النماذج OpenAI Compatible، فهو يجلب النماذج من /v1/models، والمسار في BroadNet لا يُدرج إلا نموذجَي التفريغ الصوتي.

Langflow أداة مرئية مفتوحة المصدر لبناء الوكلاء ومسارات RAG. ولمكوّن **OpenAI** فيها حقل **OpenAI API Base** يتيح، بعبارة المكوّن نفسه، “use other APIs” (ترجمة: استخدام واجهات API أخرى). وبما أن BroadNet Inference تقدّم chat completions على `https://inference.broadnet.ai/v1`، فإن هذا المكوّن يعمل مع معرّف نموذج من BroadNet تكتبه يدويًا. BroadRouter هو موقع BroadNet نفسها؛ وتتبع الخطوات توثيق Langflow 1.13.x والشيفرة المصدرية للمكوّن في v1.13.2.

## الإعداد

1.  **أضف المكوّن.** في المسار (flow)، افتح لوحة المكوّنات وأضف **OpenAI** من حزمة OpenAI. يثبّت Langflow 1.13.2 هذه الحزمة مع الحزمة الرئيسية.
    
2.  **Model Name.** انقر الحقل واكتب `broadnet/glm-5.3`. فهو يقبل قيمًا مخصّصة، فلست مقيّدًا بنماذج OpenAI الموجودة في القائمة.
    
3.  **OpenAI API Key.** الصق مفتاح BroadNet، أو اختر متغيرًا عامًا (global variable) يحمله.
    
4.  **الإعدادات المتقدمة.** افتح عناصر التحكم في المكوّن واضبط:
    
    | الحقل | القيمة |
    | --- | --- |
    | OpenAI API Base | `https://inference.broadnet.ai/v1` |
    | Max Tokens | 4000 |
    
5.  **شغّله.** اربط Chat Input وChat Output، وافتح Playground وأرسل رسالة. إن جاء رد، فالإعدادات صحيحة.
    

## فحصان في Langflow قد يحجبان BroadNet

الحماية من SSRF مفعّلة افتراضيًا في Langflow 1.13. وتهمّك قاعدتان:

-   **المفاتيح القادمة من بيئة الخادم.** إذا جاء مفتاح API من بيئة الخادم (مثل متغير عام يُحمَّل من متغير بيئة)، يرفض Langflow إرساله إلى نقطة نهاية غير افتراضية ما لم يكن المضيف في قائمة السماح. يضبط المشغّل:
    
    ```bash
    export LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS=inference.broadnet.ai
    ```
    
    أما المفتاح المكتوب داخل المكوّن فلا يتأثر.
    
-   **العناوين الخاصة.** عناوين loopback وعناوين IP الخاصة محجوبة ما لم تكن في `LANGFLOW_SSRF_ALLOWED_HOSTS`. وBroadNet مضيف HTTPS عام، فلا يهمّك هذا إلا إذا مرّرت الطلبات عبر وكيل (proxy) محلي.
    

## لماذا لا نستخدم مزوّد OpenAI Compatible؟

في Langflow 1.13 أيضًا مزوّد نماذج باسم **OpenAI Compatible** تحت **Settings → Model Providers**. ويقول توثيقه إنه يتحقق من الاتصال عبر المسار `/v1/models` في نقطة النهاية ويعرض النماذج التي يجدها. وحين تحققنا في 16 نوفمبر 2026، لم يُدرج المسار `/v1/models` في BroadNet إلا `broadnet/cohere-transcribe-arabic` و`broadnet/cohere-transcribe`، فلا يمكن اختيار نماذج المحادثة هناك. أما اسم النموذج المكتوب يدويًا في مكوّن OpenAI فيتجاوز هذه المشكلة.

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

| المسار | النموذج |
| --- | --- |
| مكوّن Agent مع الأدوات | `broadnet/glm-5.3` |
| مسارات فيها صور أو نصوص عربية، مع الأدوات | `broadnet/qwen3.8-27b` |
| مسارات المستندات الطويلة، على خطة بسعر ثابت | `broadnet/deepseek-v4.1-flash` |
| تجربة Langflow بالرصيد المبدئي | `broadnet/gemma-4-26b-a4b` (سياق 32,768 رمزًا) |

يُدرج توثيق BroadNet الأدوات والمخرجات المنظَّمة لنموذجَي GLM 5.3 وQwen3.8 27B فقط. يرسل خيار **JSON Mode** في المكوّن `response_format: {"type": "json_object"}`؛ فاستخدمه مع هذين النموذجين. [أسعار كل النماذج](https://broadrouter.com/ar/pricing/).

## كيف اختبرنا هذا

لم نشغّل واجهة Langflow. في 2026-11-15 ثبّتنا `lfx` 1.13.2 وحزمة `lfx-openai`، التي يطابق ملف مكوّن OpenAI فيها الشيفرة المصدرية في v1.13.2، وبنينا المكوّن بلغة Python مقابل خادم وهمي (mock) محلي يتحدث بنية chat completions الخاصة بـ BroadNet. مع مفتاح مكتوب في المكوّن وضبط `LANGFLOW_SSRF_ALLOWED_HOSTS` للخادم الوهمي المحلي، ذهب الطلب إلى `/v1/chat/completions` بمعرّف النموذج `broadnet/glm-5.3` دون تغيير، ومفتاح Bearer، و`temperature: 0.1`، وقيمة `seed`. وأُرسلت قيمة Max Tokens في الحقل `max_completion_tokens`، بينما يصف المرجع التقني لـ BroadNet الحقل `max_tokens`. أما المفتاح المنسوخ من بيئة الخادم فرُفض حتى ضبطنا `LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS` أيضًا. لم يكن لدينا مفتاح BroadNet، لذا لم نختبر مخرجات نموذج حقيقية.

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

-   **“Refusing to send a server-provisioned API credential”** (ترجمة: رفض إرسال بيانات اعتماد API مصدرها الخادم). أضف `inference.broadnet.ai` إلى `LANGFLOW_PROVIDER_CREDENTIAL_ALLOWED_HOSTS`، أو اكتب المفتاح في المكوّن.
-   **401.** المفتاح خاطئ، أو منتهي الصلاحية، أو استنفد رصيده.
-   **404.** يجب أن ينتهي OpenAI API Base بـ `/v1`، وأن يطابق Model Name معرّف BroadNet تمامًا. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe فقط.
-   **ردود فارغة.** يُحتسب الاستدلال المنطقي ضمن حد المخرجات في DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B. ارفع Max Tokens. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

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

[مفتاح 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.

[الرصيد المدفوع مسبقًا (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، إلى أن يعود الاستخدام تحت الحد.

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

### لماذا لا يُظهر مزوّد OpenAI Compatible نموذج GLM 5.3 أو Qwen؟

يقول توثيق Langflow إن هذا المزوّد يكتشف النماذج من المسار /v1/models في نقطة النهاية. وحين تحققنا في 16 نوفمبر 2026، لم يُدرج المسار /v1/models في BroadNet إلا نموذجَي التفريغ الصوتي، فلا تظهر نماذج المحادثة أبدًا. استخدم بدلًا منه مكوّن OpenAI مع اسم نموذج مكتوب يدويًا.

### هل يمكنني كتابة نموذج غير موجود في قائمة مكوّن OpenAI؟

نعم. حقل Model Name من نوع combobox، وهذا يعني في تعريفات المدخلات في Langflow أن المستخدم يستطيع إدخال قيمة مخصّصة. اكتب معرّف BroadNet كاملًا، مثل broadnet/glm-5.3.

### لماذا يرفض Langflow إرسال مفتاحي إلى BroadNet؟

لا يرسل Langflow 1.13 مفتاح API مصدره بيئة الخادم إلى نقطة نهاية مخصّصة ما لم يسمح المشغّل بالمضيف. اضبط LANGFLOW\_PROVIDER\_CREDENTIAL\_ALLOWED\_HOSTS=inference.broadnet.ai، أو الصق المفتاح في المكوّن نفسه.

### هل يستخدم مكوّن OpenAI في Langflow واجهة Responses API؟

لا. فهو يبني ChatOpenAI من LangChain، الذي يستدعي chat completions في الطلبات العادية. وفي اختبارنا استدعى /v1/chat/completions.

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

-   [ربط Flowise بـ BroadNet Inference (عقدة OpenAI Custom Model)](https://broadrouter.com/ar/guides/flowise-openai-compatible/)
-   [إضافة BroadNet Inference إلى Dify عبر إضافة OpenAI-API-compatible](https://broadrouter.com/ar/guides/dify-openai-api-compatible/)
-   [استخدام LangChain مع BroadNet Inference](https://broadrouter.com/ar/guides/langchain-openai-base-url/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](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-langflow-openai-compatible&utm_content=page-cta) ·

**المصادر**

-   [توثيق Langflow 1.13.x، حزمة OpenAI (رُوجع في 2026-11-15)](https://docs.langflow.org/bundles-openai)
-   [توثيق Langflow 1.13.x، مزوّد OpenAI Compatible (رُوجع في 2026-11-15)](https://docs.langflow.org/bundles-openai-compatible)
-   [الشيفرة المصدرية لـ Langflow، مكوّن OpenAI عند v1.13.2 (رُوجع في 2026-11-15)](https://github.com/langflow-ai/langflow/blob/v1.13.2/src/bundles/openai/src/lfx_openai/components/openai/openai_chat_model.py)
-   [توثيق Langflow، الحماية من SSRF (رُوجع في 2026-11-16)](https://docs.langflow.org/api-keys-and-authentication#ssrf-protection)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-langflow-openai-compatible&utm_content=sources)
