تقبل واجهة API المتوافقة مع OpenAI الطلب بالشكل نفسه الذي تقبله واجهة OpenAI، لذا تعمل حزم OpenAI SDK الرسمية بعد تغيير base_url ومفتاح API. الصعوبة أن كل مزوّد يضع نقطة النهاية في مكان مختلف قليلًا. يسرد الجدول أدناه 14 مزوّدًا، وقد قرأنا بيانات كلٍّ منها من وثائق المزوّد نفسه في 15 نوفمبر 2026.
ما العنوان الأساسي (base URL) لكل مزوّد متوافق مع OpenAI؟
| المزوّد | العنوان الأساسي | ما تُدرجه وثائق التوافق مع OpenAI لديه | الفروق التي تذكرها الوثائق |
|---|---|---|---|
| OpenAI | https://api.openai.com/v1 |
كل شيء؛ فهو المرجع | القيمة الافتراضية في SDK عندما لا يُضبط شيء |
| Anthropic | https://api.anthropic.com/v1/ |
Chat completions | “Primarily intended to test and compare model capabilities” (ترجمة: مخصّصة أساسًا لاختبار قدرات النماذج ومقارنتها)؛ تتجاهل strict؛ مدخلات الصوت والملفات تعيد 400 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
Chat completions، والتضمينات، وتوليد الصور، والنماذج، والدفعات (batch) | دعم مكتبة OpenAI “still in beta” (ترجمة: لا يزال تجريبيًا)؛ لا ذكر لـ Responses API |
| DeepSeek | https://api.deepseek.com |
Chat completions | لا مسار إصدار؛ وعنوان منفصل بصيغة Anthropic على /anthropic |
| Groq | https://api.groq.com/openai/v1 |
Chat completions وResponses API؛ وملاحظات عن تحويل الصوت إلى نص | logprobs وlogit_bias وtop_logprobs وmessages[].name تعيد 400؛ يجب أن تكون n مساوية لـ 1؛ لا نصوص مفرّغة بصيغة srt أو vtt |
| Together AI | https://api.together.ai/v1 |
المحادثة، والإكمال، والصور، والكلام، والتفريغ الصوتي، والنماذج، وResponses | استدلال داخل الولايات المتحدة فقط على https://us-api.together.ai/v1؛ التضمينات على نقاط النهاية المخصّصة فقط |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
Chat completions | معرّفات النماذج بصيغة accounts/fireworks/models/…؛ يخفّض max_tokens لتلائم السياق بدلًا من إعادة خطأ، ما لم يُطلب منه غير ذلك |
| DeepInfra | https://api.deepinfra.com/v1/openai |
Chat completions؛ وعملاء Responses يستخدمون العنوان الأساسي نفسه | التضمينات والصور والكلام موثّقة في صفحة منفصلة |
| Mistral AI | https://api.mistral.ai/v1 |
POST /v1/chat/completions |
لا يصف مرجعه التقني نفسه بأنه متوافق مع OpenAI؛ اختبره قبل الاعتماد عليه |
| OpenRouter | https://openrouter.ai/api/v1 |
Chat completions | ترويستا HTTP-Referer وX-OpenRouter-Title اختياريتان لتصنيفاته |
| xAI | https://api.x.ai/v1 |
Responses API | يقول دليله: “The Responses API is the preferred way of interacting with our models” (ترجمة: واجهة Responses API هي الطريقة المفضّلة للتعامل مع نماذجنا) |
| Z.ai (GLM) | https://api.z.ai/api/paas/v4/ |
Chat completions | المسار v4 وليس v1 |
| Alibaba Model Studio | https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 (سنغافورة) |
Chat completions | معرّف مساحة العمل جزء من اسم المضيف؛ ولا يعمل المفتاح إلا في المنطقة التي أُنشئ فيها، وإلا فالنتيجة 401 |
| BroadNet Inference | https://inference.broadnet.ai/v1 |
Chat completions، وتحويل الصوت إلى نص (audio transcriptions) | تبدأ معرّفات النماذج بـ broadnet/؛ انظر أدناه |
تُدرج Alibaba أيضًا نقطة نهاية في الولايات المتحدة (فرجينيا) على us-east-1. أما صف بكين في الصفحة نفسها فيعرض مضيف سنغافورة، بينما يذكر نص آخر في الصفحة cn-beijing، لذا تأكّد من نقطة النهاية الصينية في لوحة التحكم. الجدول لقطة في لحظة معيّنة، ونقاط النهاية تتغيّر: فقد أُعيد توجيه وثائق Anthropic وGoogle كلتيهما إلى عناوين جديدة أثناء مراجعتنا لها.
لمعرفة الأسعار لدى هؤلاء المزوّدين، راجع صفحات أسعار LLM API حسب المزوّد.
كيف تضبط العنوان الأساسي في الشيفرة؟
في Python، مرّر base_url إلى العميل:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://inference.broadnet.ai/v1",
api_key=os.environ["BROADNET_API_KEY"],
)
r = client.chat.completions.create(
model="broadnet/gemma-4-26b-a4b",
messages=[{"role": "user", "content": "Say hello in one line."}],
)
print(r.choices[0].message.content)
في Node، اسم الخيار baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://inference.broadnet.ai/v1",
apiKey: process.env.BROADNET_API_KEY,
});
أو اضبطه مرة واحدة لكل أداة تستخدم حزم SDK الرسمية. تجعل الشيفرة المصدرية لحزمة Node SDK القيمة الافتراضية لـ baseURL هي process.env['OPENAI_BASE_URL']، ثم https://api.openai.com/v1؛ ويوثّق ملف README الخاص بـ Python المتغير نفسه:
export OPENAI_BASE_URL="https://inference.broadnet.ai/v1"
export OPENAI_API_KEY="your-key"
الشرح الكامل خطوة بخطوة: OpenAI Python SDK وOpenAI Node SDK. ولمعرفة ما هو العنوان الأساسي (base URL) ولماذا تطلبه الأدوات، راجع المسرد.
كيف تختبر عنوانًا أساسيًا جديدًا باستخدام curl؟
أرسل طلبًا صغيرًا واحدًا قبل أن تغيّر أي شيء في شيفرة تطبيقك:
curl https://inference.broadnet.ai/v1/chat/completions \
-H "Authorization: Bearer $BROADNET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "broadnet/gemma-4-26b-a4b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 20}'
استبدل العنوان الأساسي والمفتاح والنموذج بما يخص المزوّد الذي تختبره. إذا حصلت على 200 مع مصفوفة choices فالمسار والمفتاح ومعرّف النموذج صحيحة. أما 404 فتعني عادةً أن المسار خاطئ، و401 تعني أن المفتاح أو المنطقة خاطئة، و400 كثيرًا ما تذكر المعامل الذي يرفضه المزوّد. يضم دليل البدء السريع مع curl أمثلة أكثر، كما يكتب لك منشئ طلبات API نسخ curl وPython وNode.
ما الأخطاء الشائعة عند تغيير base_url؟
- لصق نقطة النهاية كاملة. تُلحق حزمة SDK المسار
/chat/completions. والعنوان الأساسي الذي ينتهي به أصلًا يُنتج/chat/completions/chat/completionsوخطأ 404. - إضافة
/v1أو حذفها بحكم العادة. العنوان الأساسي الموثّق لدى DeepSeek لا يحتوي على/v1، وعنوان Z.ai ينتهي بـ/v4/، وعنوان Gemini ينتهي بـ/v1beta/openai/. انسخ النص الدقيق كما يورده المزوّد. - الإبقاء على أسماء نماذج OpenAI. أسماء
gpt-…تفشل في أي مكان آخر. لكل مزوّد صيغته:deepseek-ai/DeepSeek-V4-Flash-0731على DeepInfra، وaccounts/fireworks/models/…على Fireworks، وbroadnet/deepseek-v4.1-flashعلى BroadNet. - إرسال معاملات يرفضها المزوّد أو يتجاهلها. يعيد Groq الخطأ 400 مع
logprobs، وتتجاهل طبقة Anthropic بصمتseedوlogit_biasوreasoning_effort. والمعامل الذي يُتجاهل بصمت أسوأ من الخطأ، لأن لا شيء ينبّهك إليه. - افتراض أن حقول الاستجابة هي نفسها. تعيد طبقة Anthropic الحقل
prompt_tokens_detailsفارغًا، فيغيب الإبلاغ عن الرموز المخزّنة مؤقتًا. ويضع Fireworks بيانات الاستهلاك في البث داخل الجزء الأخير، وقد لا تعرّفه أنواع حزمة SDK. - افتراض وجود كل نقاط النهاية. عبارة «متوافقة مع OpenAI» تعني عادةً chat completions. أما التضمينات والصوت وتوليد الصور وResponses API فكلٌّ منها مسألة مستقلة، كما يبيّن الجدول.
- الخلط بين المناطق. مفاتيح Alibaba مرتبطة بمنطقة، وتوفّر Together مضيفًا منفصلًا للولايات المتحدة فقط. والمفتاح الصالح على المضيف الخطأ يفشل رغم ذلك.
القائمة الكاملة لما يجب فحصه قبل التبديل موجودة في قائمة التحقق للانتقال إلى واجهة متوافقة مع OpenAI.
ما نقاط النهاية التي تدعمها BroadNet Inference؟
يوثّق المرجع التقني لواجهة API لدى BroadNet نقطتَي نهاية للنماذج على https://inference.broadnet.ai/v1، إضافةً إلى GET /v1/models لبيانات الفهرس الوصفية:
| نقطة النهاية | النماذج |
|---|---|
POST /v1/chat/completions |
DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B وBroadNet Gemma 4 VL 26B |
POST /v1/audio/transcriptions |
BroadNet Transcribe Arabic وBroadNet Transcribe (14 لغة) |
ماذا يعني ذلك عمليًا:
- لا توثيق للتضمينات ولا لتوليد الصور ولا لـ Responses API. الأداة التي تحتاج إلى أحدها تحتاج إلى مزوّد ثانٍ لذلك الجزء.
- استدعاء الأدوات والمخرجات المنظَّمة موثّقان لـ GLM 5.3 وQwen3.8 27B.
- تُرسل الصور بصيغة عناوين
data:داخل أجزاء المحتوىimage_url، على DeepSeek V4.1 Flash وQwen3.8 27B وGemma 4 VL 26B. - نماذج الاستدلال المنطقي (DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B) تحتسب الاستدلال ضمن
max_tokens. اترك 1,000 رمز (توكن) أو أكثر، أو اضبطreasoning_effortعلىlow، كما توصي الوثائق؛ وانظر لماذا تعيد نماذج الاستدلال المنطقي إجابات فارغة. - أجابت نقطة قائمة النماذج عندما استدعينا
GET /v1/modelsفي 15 نوفمبر 2026، لكنها ليست ضمن قائمة نقاط النهاية الموثّقة، فلا تبنِ عليها. - الحدود على مفاتيح الدفع حسب الاستخدام هي 30 طلبًا في الدقيقة و4 قيد التنفيذ في آنٍ واحد.
الأسعار لكل مليون رمز: DeepSeek V4.1 Flash بسعر $0.175 للإدخال و$0.52 للإخراج، وGemma 4 VL 26B بسعر $0.10 و$0.22. ويُباع DeepSeek V4.1 Flash أيضًا بخطة ثابتة السعر قدرها $60 شهريًا لكل جلسة، بطلب واحد في كل مرة.
هل تمرّر عدة مزوّدين عبر عنوان أساسي واحد؟
إذا كان تطبيقك يستدعي عدة مزوّدين من هؤلاء، فإن وكيلًا (proxy) مثل LiteLLM يمنح شيفرتك عنوانًا أساسيًا واحدًا ويربط أسماء النماذج بكل مزوّد خلفي. أنت من يحدّد هذا الربط؛ ولا شيء يبدّل المزوّدين نيابةً عنك ما لم تضبط آليات التحويل الاحتياطي (fallbacks) بنفسك. يشرح مقال التحويل الاحتياطي في LLM API طريقة ذلك، سواء في العميل أو في LiteLLM. ويعرض دليل وكيل LiteLLM إدخالًا خاصًا بـ BroadNet. وللاطلاع على خلفية المصطلح، راجع واجهة API المتوافقة مع OpenAI.
أين تناسب BroadNet Inference؟
تناسبك BroadNet إذا كانت شيفرتك تتعامل أصلًا بصيغة chat completions وتريد نماذج مفتوحة، أو تحويل الصوت إلى نص بالعربية ولغات متعددة، أو جلسة DeepSeek بسعر ثابت، كل ذلك بمفتاح واحد. ولا تناسبك إذا كنت تحتاج إلى التضمينات أو Responses API أو توليد الصور من المزوّد نفسه؛ فـ Together AI وGemini يوثّقان جزءًا أكبر من واجهة OpenAI. قارن جدولنا بوثائق كل مزوّد قبل الإطلاق، لأن هذه العناوين وقوائم نقاط النهاية تتغيّر.
