أصبحت صيغة 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). استخدم معرّف النموذج لدى المزوّد. - افتراض أن معاملًا يعمل لأن الطلب نجح. بعض المزوّدين يتجاهلون الحقول غير المعروفة بصمت.