BroadRouter
ابدأ الآن

واجهة API متوافقة مع OpenAI (OpenAI-compatible API)

آخر تحديث

واجهة API المتوافقة مع OpenAI هي واجهة HTTP تقبل صيغ الطلبات والاستجابات نفسها التي تستخدمها OpenAI API، مثل POST /v1/chat/completions، فتستطيع حزم OpenAI SDK وأدواتها استخدامها بتغيير العنوان الأساسي (base URL) ومفتاح API واسم النموذج فقط.

يُسمّى أيضًا: واجهة متوافقة مع OpenAI، API متوافق مع OpenAI، بديل مباشر لـ OpenAI، OpenAI-compatible API، OpenAI API compatible، OpenAI-style API، OpenAI drop-in replacement

أصبحت صيغة OpenAI API اللغة المشتركة لأدوات نماذج اللغة الكبيرة. يقبلها اليوم كثير من المزوّدين، فتستطيع مكتبة عميل واحدة التخاطب مع خوادم كثيرة.

كيف تعمل

تنسخ الواجهة المتوافقة أجزاء OpenAI API التي يعتمد عليها العملاء:

  • المسارات نفسها، مثل /v1/chat/completions و/v1/audio/transcriptions؛
  • صيغ JSON نفسها: مصفوفة messages في الطلب، وchoices[0].message.content في الرد، وكتلة usage بأعداد الرموز؛
  • مفتاح API يُرسل بالصيغة Authorization: Bearer <key>؛
  • البث المتدفق بأحداث server-sent events حين تكون قيمة stream هي true.

التبديل مجرد تغيير في الإعدادات. مع حزمة Python SDK الرسمية:

from openai import OpenAI
import os

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
reply = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Say hello in Arabic."}],
)
print(reply.choices[0].message.content)

تغيّرت ثلاث قيم فقط عن مثال OpenAI: العنوان الأساسي، والمفتاح، ومعرّف النموذج.

لماذا تهم

يخفّض التوافق كلفة التبديل. فحزم SDK وأطر الوكلاء وإضافات بيئات التطوير والموجّهات (routers) التي تتحدث بصيغة OpenAI تعمل دون شيفرة جديدة. يمكنك اختبار مزوّد ثانٍ في دقائق والاحتفاظ بخيار الانتقال.

لكن المتوافق ليس مطابقًا. فطبقة التوافق لدى Anthropic نفسها، مثلًا، تتجاهل strict في الأدوات وتترك prompt_tokens_details فارغًا. ومن الفجوات المعتادة:

  • معاملات تُتجاهل أو تُرفض؛
  • طريقة احتساب رموز الاستدلال المنطقي ضمن max_tokens؛
  • هل يُبلَّغ عن الاستهلاك في نهاية البث أم لا؛
  • حدود المعدل ورموز الأخطاء.

في BroadNet Inference

يقدّم BroadNet Inference POST /v1/chat/completions وPOST /v1/audio/transcriptions وGET /v1/models على https://inference.broadnet.ai/v1. ولا تُرسل المفاتيح إلا بالصيغة Authorization: Bearer <key>. يعرض دليلا Python وNode الإعداد الكامل، ويعمل LangChain بالطريقة نفسها.

خطّط لفرقين: تُجري نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B استدلالًا منطقيًا قبل الإجابة، ويُحتسب الاستدلال ضمن max_tokens. كما يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات في آنٍ واحد. وتغطي قائمة التحقق للانتقال بقية النقاط.

أخطاء شائعة

  • الإبقاء على اسم نموذج من OpenAI مثل gpt-6-astra (النموذج الرائد لدى OpenAI على صفحة النماذج لديها، تاريخ المراجعة 2026-11-15). استخدم معرّف النموذج لدى المزوّد.
  • افتراض أن معاملًا يعمل لأن الطلب نجح. بعض المزوّدين يتجاهلون الحقول غير المعروفة بصمت.

أسئلة شائعة

هل يعني التوافق مع OpenAI أن كل ميزات OpenAI تعمل؟

لا. يعني أن الصيغ الأساسية للطلبات والاستجابات متطابقة. وقد تُتجاهل حقول بعينها أو تُرفض. فطبقة التوافق لدى Anthropic مثلًا توثّق حقولًا تتجاهلها وأخرى تُرجع خطأ 400. اقرأ قائمة المزوّد قبل أن تعتمد على أي معامل.

هل أحتاج إلى حزمة SDK مختلفة؟

لا. تقبل حزم OpenAI SDK الرسمية عنوانًا أساسيًا مخصّصًا. مرّر base_url في Python، أو baseURL في Node، أو اضبط متغير البيئة OPENAI_BASE_URL.

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

POST /v1/chat/completions للمحادثة، وPOST /v1/audio/transcriptions لتحويل الكلام إلى نص. وتوجد أيضًا GET /v1/models، لكن وثائق BroadNet تصفها بأنها بيانات وصفية عامة للكتالوج مخصّصة لأدوات المراقبة الخارجية، لذا خذ معرّفات النماذج لطلباتك من مرجع API.

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