BroadRouter
ابدأ الآن

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

آخر تحديث

العنوان الأساسي (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 SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
// 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 تبديلًا مباشرًا. وهو أيضًا ما يحدّد أين تذهب أوامرك ومن يصدر لك الفاتورة. والقيمة الخاطئة قد ترسل حركة الطلبات، ومفتاح API الخاص بك، إلى المزوّد الخطأ. احفظه في الإعدادات بجوار المفتاح، لا مكتوبًا يدويًا في عدة أماكن.

وتستخدم الموجّهات الفكرة نفسها: توجّه العنوان الأساسي إلى الموجّه (router) بدلًا من مزوّد النماذج.

في BroadNet Inference

العنوان الأساسي هو https://inference.broadnet.ai/v1 لكل النماذج: المحادثة والرؤية وتحويل الكلام إلى نص. تذهب المحادثة إلى /chat/completions والتفريغ الصوتي إلى /audio/transcriptions. يعرض البدء السريع بـ curl أول طلب، ويوضّح دليل LangChain مكان هذا الإعداد في إطار عمل.

أخطاء شائعة

  • غياب /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.

هل تنقل تطبيقًا كاملًا؟ اتبع قائمة التحقق للانتقال.

أسئلة شائعة

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

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

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

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

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

https://inference.broadnet.ai/v1

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity