---
title: "ما هو العنوان الأساسي (base URL) في LLM API؟ مع أمثلة"
description: "العنوان الأساسي (base URL) هو الجذر الذي تضعه حزمة SDK قبل كل مسار في الواجهة. كيف يعمل في العملاء المتوافقين مع OpenAI، والأخطاء التي تسبّب 404."
url: https://broadrouter.com/ar/glossary/base-url/
lang: ar
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# العنوان الأساسي (Base URL)

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

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

يُسمّى أيضًا: عنوان URL الأساسي، العنوان الأساسي للواجهة، base\_url، عنوان نقطة النهاية، base URL، API base URL، api\_base، baseURL، OPENAI\_BASE\_URL، endpoint URL

كل طلب ترسله حزمة SDK هو العنوان الأساسي مضافًا إليه مسار. اضبط العنوان الأساسي بشكل صحيح، وسيعمل بقية العميل دون تغيير.

## كيف يعمل

يجمع العميل جزأين:

| الجزء | مثال |
| --- | --- |
| العنوان الأساسي | `https://inference.broadnet.ai/v1` |
| مسار نقطة النهاية | `/chat/completions` |
| عنوان الطلب الكامل | `https://inference.broadnet.ai/v1/chat/completions` |

في الشيفرة، يعتمد اسم المعامل على المكتبة:

```python
# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
```

```js
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });
```

تلجأ الحزمتان الرسميتان كلتاهما إلى متغير البيئة `OPENAI_BASE_URL`، ثم إلى عنوان OpenAI نفسها إن لم يُضبط شيء. وتستخدم أدوات أخرى أسماء مثل `api_base` أو `OPENAI_API_BASE`.

## لماذا يهم

العنوان الأساسي هو ما يجعل [واجهة API المتوافقة مع OpenAI](https://broadrouter.com/ar/glossary/openai-compatible-api/) تبديلًا مباشرًا. وهو أيضًا ما يحدّد أين تذهب أوامرك ومن يصدر لك الفاتورة. والقيمة الخاطئة قد ترسل حركة الطلبات، و[مفتاح API](https://broadrouter.com/ar/glossary/api-key/) الخاص بك، إلى المزوّد الخطأ. احفظه في الإعدادات بجوار المفتاح، لا مكتوبًا يدويًا في عدة أماكن.

وتستخدم الموجّهات الفكرة نفسها: توجّه العنوان الأساسي إلى [الموجّه (router)](https://broadrouter.com/ar/glossary/llm-router/) بدلًا من مزوّد النماذج.

## في BroadNet Inference

العنوان الأساسي هو `https://inference.broadnet.ai/v1` لكل النماذج: المحادثة والرؤية وتحويل الكلام إلى نص. تذهب المحادثة إلى `/chat/completions` والتفريغ الصوتي إلى `/audio/transcriptions`. يعرض [البدء السريع بـ curl](https://broadrouter.com/ar/guides/curl-quickstart/) أول طلب، ويوضّح [دليل LangChain](https://broadrouter.com/ar/guides/langchain-openai-base-url/) مكان هذا الإعداد في إطار عمل.

## أخطاء شائعة

-   **غياب `/v1`.** العنوان `https://inference.broadnet.ai` دون `/v1` يجعل حزمة SDK تُرجع أخطاء 404.
-   **مسار مكرَّر.** لصق نقطة النهاية الكاملة، مثل `.../v1/chat/completions`، بوصفها العنوان الأساسي يجعل حزمة SDK تستدعي `.../chat/completions/chat/completions`.
-   **متغيرات بيئة متبقية.** قيمة قديمة لـ `OPENAI_BASE_URL` في الطرفية تتغلب على ما تتوقعه. اطبعها حين تذهب الطلبات إلى المكان الخطأ.
-   **HTTP العادي.** استخدم `https://` دائمًا. يجب أن تنتقل مفاتيح Bearer عبر TLS.
-   **تغيير العنوان دون تغيير النموذج.** لكل مزوّد معرّفات نماذجه، مثل `broadnet/deepseek-v4.1-flash`.

هل تنقل تطبيقًا كاملًا؟ اتبع [قائمة التحقق للانتقال](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/).

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

### هل يجب أن ينتهي العنوان الأساسي بـ /v1؟

في حزم SDK المتوافقة مع OpenAI، نعم، حين تبدأ مسارات المزوّد بـ /v1. فتُلحق حزمة SDK بعده مسارات مثل /chat/completions. راجع وثائق المزوّد للقيمة الدقيقة.

### هل يمكنني ضبط العنوان الأساسي دون تغيير الشيفرة؟

نعم. تقرأ حزمتا OpenAI الرسميتان لـ Python وNode متغير البيئة OPENAI\_BASE\_URL حين لا تمرّر عنوانًا أساسيًا. وتستخدم بعض الأدوات أسماء متغيرات خاصة بها، مثل OPENAI\_API\_BASE في Aider.

### ما هو العنوان الأساسي لـ BroadNet Inference؟

https://inference.broadnet.ai/v1

## انظر أيضًا

-   [واجهة API متوافقة مع OpenAI (OpenAI-compatible API)](https://broadrouter.com/ar/glossary/openai-compatible-api/) (مصطلح)
-   [مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/) (مصطلح)
-   [موجّه LLM (LLM router)](https://broadrouter.com/ar/glossary/llm-router/) (مصطلح)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [استخدام OpenAI Node.js SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-node-sdk/) (دليل)
-   [استخدام LangChain مع BroadNet Inference](https://broadrouter.com/ar/guides/langchain-openai-base-url/) (دليل)
-   [أول طلب إلى BroadNet Inference باستخدام curl](https://broadrouter.com/ar/guides/curl-quickstart/) (دليل)
-   [الانتقال إلى واجهة API متوافقة مع OpenAI: قائمة تحقق للترحيل](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/) (مقال)

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

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

**المصادر**

-   [ملف README لـ OpenAI Python SDK (base\_url وOPENAI\_BASE\_URL)](https://github.com/openai/openai-python)
-   [OpenAI Node SDK (baseURL، وقيمته الافتراضية من OPENAI\_BASE\_URL)](https://github.com/openai/openai-node)
-   [دليل البدء السريع في OpenRouter (مثال على عنوان أساسي لجهة خارجية)](https://openrouter.ai/docs/quickstart)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-base-url&utm_content=sources)
