معظم شيفرة LLM المنتشرة تتكلم لهجة واحدة: قائمة رسائل تدخل، ورسالة واحدة تخرج. وهذه اللهجة هي Chat Completions API.
كيف تعمل
ترسل JSON بطلب POST إلى /v1/chat/completions مع model ومصفوفة messages. لكل رسالة role (system أو user أو assistant أو tool) وcontent. ويحمل الرد مصفوفة choices؛ وكل خيار يحمل message وfinish_reason الذي يوضّح سبب انتهاء التوليد، إضافةً إلى كتلة usage بأعداد الرموز.
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":"system","content":"Answer in one line."},
{"role":"user","content":"What is a token?"}]}'
في OpenAI Python SDK، الاستدعاء نفسه هو client.chat.completions.create(...). وتشكّل الحقول الاختيارية المخرجات: max_tokens وtemperature وstream وtools وresponse_format وغيرها.
الواجهة عديمة الحالة. ويقول دليل الانتقال لدى OpenAI إنه في Chat Completions “conversation state must be managed manually” (ترجمة: يجب إدارة حالة المحادثة يدويًا): أي أن شيفرتك تحتفظ بالسجل وترسله من جديد في كل دورة. أما Responses API الأحدث لدى OpenAI فتستخدم عناصر محدّدة الأنواع ويمكنها حفظ الحالة على الخادم، وتوصي بها OpenAI للمشاريع الجديدة على منصتها، لكنها تقول إن Chat Completions “remains supported” (ترجمة: ما زالت مدعومة).
لماذا تهم
- قابلية النقل. الواجهة المتوافقة مع OpenAI تعني عادةً نقطة النهاية هذه. وتغيير المزوّد كثيرًا ما يعني عنوان URL أساسيًا جديدًا ومفتاحًا واسم نموذج جديدين.
- التكلفة. لأن السجل كله يُعاد إرساله، تزداد رموز الإدخال في كل دورة. اختصر المحادثات الطويلة أو لخّصها.
- تباين الحقول. لا يقبل كل المزوّدين المتوافقين كل حقول OpenAI. وقد تُتجاهل الحقول غير المعروفة أو تُرفض، فاختبر الحقول التي تعتمد عليها.
في BroadNet Inference
يقدّم BroadNet المحادثة عبر POST /v1/chat/completions على https://inference.broadnet.ai/v1، لنماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B وGemma 4 VL 26B. ويستخدم البث المتدفق stream=true وينتهي بـ data: [DONE]. واستدعاء الأدوات والمخرجات المنظَّمة موثّقان لنموذجي GLM 5.3 وQwen3.8 27B فقط. ولا يوثّق المرجع التقني لـ BroadNet نقطة نهاية لـ Responses، فاستخدم Chat Completions. ابدأ بـ البدء السريع مع curl أو دليل Python SDK.
أخطاء شائعة
- إرسال آخر رسالة من المستخدم وحدها وتوقّع أن يتذكر النموذج المحادثة.
- نسخ حقول خاصة بـ OpenAI إلى مزوّد آخر دون مراجعة مرجعه التقني.