BroadRouter

Chat Completions API (واجهة إكمال المحادثة)

آخر تحديث

Chat Completions API هي نقطة نهاية HTTP لدى OpenAI، أي POST /v1/chat/completions، تستقبل اسم نموذج وقائمة رسائل موسومة بأدوارها وتُرجع الرسالة التالية من النموذج. وصارت بنية طلبها واستجابتها الصيغة المشتركة التي يعيد استخدامها المزوّدون المتوافقون مع OpenAI وحزم SDK.

يُسمّى أيضًا: واجهة إكمال المحادثة، إكمال المحادثة، نقطة نهاية chat completions، Chat Completions API، Chat Completions، chat completions endpoint، /v1/chat/completions، chat.completions.create

معظم شيفرة 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 إلى مزوّد آخر دون مراجعة مرجعه التقني.

أسئلة شائعة

هل Chat Completions API مُهمَلة؟

لا. يقول دليل الانتقال لدى OpenAI إن "Chat Completions remains supported" (ترجمة: ما زالت Chat Completions مدعومة)، مع أنه يوصي بـ Responses API الأحدث للمشاريع الجديدة على OpenAI.

هل تتذكر Chat Completions API الرسائل السابقة؟

لا. فهي عديمة الحالة (stateless). ويقول دليل OpenAI إن حالة المحادثة "must be managed manually" (ترجمة: يجب إدارتها يدويًا)، لذا ترسل سجل الرسائل كاملًا مع كل طلب.

أي نقطة نهاية يستخدمها BroadNet Inference للمحادثة؟

POST /v1/chat/completions على عنوان URL الأساسي https://inference.broadnet.ai/v1. ولا يوثّق BroadNet نقطة نهاية لـ Responses API.

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