BroadRouter
ابدأ الآن

عناوين base URL لواجهات API المتوافقة مع OpenAI: فحص 14 مزوّدًا

بقلم فريق BroadNet Inference · قراءة في 6 دقائق · تاريخ النشر

تتيح لك واجهة API المتوافقة مع OpenAI الإبقاء على OpenAI SDK وتغيير أمرين فقط: base_url ومفتاح API. يختلف العنوان الأساسي من مزوّد لآخر، مثل https://api.groq.com/openai/v1 لدى Groq، وhttps://openrouter.ai/api/v1 لدى OpenRouter، وhttps://inference.broadnet.ai/v1 لدى BroadNet Inference. لكن المسارات ومعرّفات النماذج والمعاملات المدعومة تظل مختلفة، فاختبر طلبًا واحدًا قبل التبديل.

تقبل واجهة 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. قارن جدولنا بوثائق كل مزوّد قبل الإطلاق، لأن هذه العناوين وقوائم نقاط النهاية تتغيّر.

أسئلة شائعة

ما هو العنوان الأساسي (base URL) لواجهة OpenAI API؟

https://api.openai.com/v1. تستخدمه حزمة Node SDK الرسمية عندما لا تضبط baseURL ولا متغير البيئة OPENAI_BASE_URL.

هل يجب أن ينتهي base_url بـ /v1 أم بـ /chat/completions؟

أنهِه حيث تنهيه وثائق المزوّد، وغالبًا ما يكون ذلك /v1. تضيف حزمة SDK المسار /chat/completions بنفسها، لذا فإن عنوانًا أساسيًا ينتهي أصلًا بـ /chat/completions يُنتج خطأ 404.

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

نعم. تقرأ حزمتا OpenAI SDK الرسميتان المتغير OPENAI_BASE_URL، وكذلك كثير من الأدوات المبنية عليهما. اضبط OPENAI_API_KEY معه، وراجع وثائق كل أداة، لأن بعضها يستخدم أسماء متغيرات خاصة به.

هل واجهة Claude API متوافقة مع OpenAI؟

جزئيًا. توفّر Anthropic العنوان https://api.anthropic.com/v1/ للاستخدام مع OpenAI SDK، لكنها تقول إن هذه الطبقة مخصّصة أساسًا لاختبار النماذج ومقارنتها، وليست مسارًا للإنتاج على المدى الطويل. وهي تتجاهل strict في الأدوات وترفض مدخلات الصوت والملفات.

ما نقاط النهاية التي تدعمها BroadNet Inference؟

تُدرج وثائقها POST /v1/chat/completions وPOST /v1/audio/transcriptions. ولا تُدرج التضمينات (embeddings) ولا توليد الصور ولا Responses API.

لماذا ينجح طلبي مع OpenAI ويفشل لدى مزوّد آخر؟

السبب عادةً معرّف نموذج بصيغة خاطئة، أو معامل يرفضه المزوّد. فمثلًا يعيد Groq الخطأ 400 مع logprobs وlogit_bias وtop_logprobs وmessages[].name. احذف المعاملات الاختيارية وأعد المحاولة بمعرّف النموذج الدقيق لدى المزوّد.

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