كل طلب ترسله حزمة 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.
هل تنقل تطبيقًا كاملًا؟ اتبع قائمة التحقق للانتقال.