---
title: "LangChain ChatOpenAI مع base_url مخصّص | BroadRouter"
description: "اربط ChatOpenAI في LangChain بـ BroadNet Inference عبر base_url وapi_key، واعرف ما الذي يحتفظ به LangChain وما الذي يُسقطه من نماذج الاستدلال المنطقي."
url: https://broadrouter.com/ar/guides/langchain-openai-base-url/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام LangChain مع BroadNet Inference

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

ثبّت الحزمة langchain-openai، ثم أنشئ ChatOpenAI مع ضبط base\_url على https://inference.broadnet.ai/v1، وapi\_key على مفتاح BroadNet، ومعرّف نموذج من BroadNet مثل broadnet/glm-5.3. بعدها تعمل سلاسل invoke والبث واستدعاء الأدوات عبر chat completions. تجنّب الميزات الخاصة بـ Responses API، واترك في max\_tokens مساحة للاستدلال المنطقي.

يقبل `ChatOpenAI` في LangChain أي نقطة نهاية عبر `base_url`. وهذا يعمل مع BroadNet Inference لأنها تستخدم بنية chat completions القياسية. أما إن كنت تستدعي الواجهة مباشرة، فراجع [دليل Python SDK](https://broadrouter.com/ar/guides/openai-python-sdk/).

## التثبيت

تحتاج الإصدارات الحالية من `langchain-openai` (السلسلة 1.x) إلى Python 3.11 أو أحدث.

```bash
pip install -U langchain-openai
export BROADNET_API_KEY='paste-the-key-once'
```

## الاتصال

```python
import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="broadnet/glm-5.3",
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=2000,  # reasoning counts toward this limit
)

print(llm.invoke("Summarise the CAP theorem in two sentences.").content)
```

الاسم `openai_api_base` بديل لـ `base_url`. وإن غاب كلاهما، يقرأ LangChain المتغيّر `OPENAI_API_BASE`، ثم يقرأ عميل `openai` الأساسي `OPENAI_BASE_URL`.

## ما يجب معرفته

-   **نص الاستدلال المنطقي لا يُحفَظ.** يقول توثيق LangChain إن `ChatOpenAI` يلتزم بمواصفة OpenAI الرسمية ولا يحتفظ بالحقول غير القياسية مثل `reasoning_content`. تحصل على الإجابة النهائية، وهي عادةً ما تحتاجه السلسلة.
-   **اترك مساحة للاستدلال المنطقي.** تبدأ نماذج GLM 5.3 وDeepSeek V4.1 Flash وQwen3.8 27B بالاستدلال المنطقي أولًا، وقد تُرجع قيمة صغيرة في `max_tokens` إجابة فارغة. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **الاستخدام أثناء البث.** حين تضبط نقطة النهاية عبر `OPENAI_BASE_URL`، يعطّل LangChain الخيار `stream_usage` افتراضيًا. مرّر `stream_usage=True` إن أردت أعداد الرموز أثناء البث. ويذكر توثيق BroadNet أن بيانات الاستخدام تصل في آخر جزء عند طلبها.
-   **ابقَ على chat completions.** تقدّم BroadNet المسار `/v1/chat/completions`، لا Responses API. ويقول توثيق LangChain إن `ChatOpenAI` ينتقل إلى Responses API حين تستخدم أدوات OpenAI المدمجة (البحث على الويب، والبحث في الملفات، ومفسّر الشيفرة وما شابهها)، أو حالة المحادثة، أو المعامل `reasoning`. لا تستخدمها، ولا تضبط `use_responses_api=True`.
-   **اسم حد الرموز.** يقول توثيق LangChain إن `max_tokens` يُحوَّل داخليًا إلى `max_completion_tokens`، بينما يصف توثيق BroadNet المعامل `max_tokens`. فإن بدا أن الحد يُتجاهَل، فافحص الطلب الذي يرسله تطبيقك.

## أي نموذج لأي سلسلة

| السلسلة | النموذج |
| --- | --- |
| استدعاء الأدوات والمخرجات المنظَّمة | `broadnet/glm-5.3` |
| المستندات الطويلة والوكلاء، الخطة غير المحدودة | `broadnet/deepseek-v4.1-flash` |
| النصوص أو الصور العربية | `broadnet/qwen3.8-27b` |

[اطّلع على أسعار كل النماذج](https://broadrouter.com/ar/pricing/).

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

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيد الدفع حسب الاستخدام. وإن لم تمرّر `api_key`، فقد استخدم LangChain المتغيّر `OPENAI_API_KEY`، وربما يحمل مفتاحًا من OpenAI.
-   **404 أو “not found”.** تأكّد أن `base_url` ينتهي بـ `/v1` وأن لا شيء يوجّه الاستدعاء إلى Responses API (انظر أعلاه). ثم تأكّد أن معرّف النموذج يطابق معرّف BroadNet تمامًا، مع البادئة `broadnet/`. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ فالرصيد المبدئي البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **الحقل `content` فارغ.** استهلك الاستدلال المنطقي الميزانية. ارفع `max_tokens`. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **لا تحدث استدعاءات الأدوات أبدًا.** استخدم `broadnet/glm-5.3` أو `broadnet/qwen3.8-27b`؛ فتوثيق BroadNet يُدرج الأدوات لهذين النموذجين فقط.
-   **الخطأ 429 في السلاسل الدفعية أو المتوازية.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آنٍ واحد. اضبط `max_concurrency` في إعدادات الـ runnable عند استدعاء `batch()`. راجع [رموز الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

[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 قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

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

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

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

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

### هل أستخدم base\_url أم openai\_api\_base في ChatOpenAI؟

أيهما شئت. فـ openai\_api\_base اسم بديل لـ base\_url. وإن لم تمرّر أيًّا منهما، يبحث LangChain عن OPENAI\_API\_BASE، ثم يقرأ عميل openai المتغيّر OPENAI\_BASE\_URL.

### هل يمكن ضبط نقطة نهاية BroadNet بمتغيّرات البيئة وحدها؟

نعم. اضبط OPENAI\_BASE\_URL على https://inference.broadnet.ai/v1 وOPENAI\_API\_KEY على مفتاح BroadNet، ثم أنشئ ChatOpenAI بمعرّف النموذج فقط. ومرّر stream\_usage=True إن أردت أعداد الرموز أثناء البث.

### لماذا يُسقط LangChain الحقل reasoning\_content من ردود BroadNet؟

يقول توثيق LangChain إن ChatOpenAI يلتزم بمواصفة OpenAI الرسمية ولا يستخرج الحقول غير القياسية مثل reasoning\_content. ومع ذلك تصلك الإجابة النهائية في content.

### هل يدعم ChatOpenAI مع BroadNet استدعاء الأدوات؟

نعم، عبر bind\_tools، على النماذج التي تُدرجها BroadNet مع دعم الأدوات. استخدم broadnet/glm-5.3 أو broadnet/qwen3.8-27b لاستدعاء الأدوات ولـ with\_structured\_output.

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

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [تشغيل OpenAI Agents SDK على BroadNet Inference](https://broadrouter.com/ar/guides/openai-agents-sdk-custom-provider/)
-   [كل الأدوات التي تعمل مع 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-langchain-openai-base-url&utm_content=page-cta) ·

**المصادر**

-   [توثيق LangChain، تكامل ChatOpenAI (رُوجع في 2026-11-14)](https://docs.langchain.com/oss/python/integrations/chat/openai)
-   [PyPI، حزمة langchain-openai (الإصدار 1.8، Python 3.11 فأحدث، رُوجع في 2026-11-14)](https://pypi.org/project/langchain-openai/)
-   [الشيفرة المصدرية لـ langchain-openai، تحديد العنوان الأساسي في ChatOpenAI (رُوجعت في 2026-11-16)](https://github.com/langchain-ai/langchain/blob/master/libs/partners/openai/langchain_openai/chat_models/base.py)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-langchain-openai-base-url&utm_content=sources)
