---
title: "ما هي Chat Completions API؟ نقطة نهاية المحادثة /v1 | BroadRouter"
description: "تستقبل Chat Completions API قائمة رسائل موسومة بأدوارها وتُرجع رد النموذج. كيف يعمل الطلب والاستجابة، ولماذا ينسخها كثير من المزوّدين."
url: https://broadrouter.com/ar/glossary/chat-completions-api/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/glossary/chat-completions-api/) (حُدّث في 2026-11-16).

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

آخر تحديث 2026-11-16

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](https://broadrouter.com/ar/glossary/finish-reason/) الذي يوضّح سبب انتهاء التوليد، إضافةً إلى كتلة `usage` بأعداد الرموز.

```bash
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](https://broadrouter.com/ar/glossary/openai-compatible-api/) تعني عادةً نقطة النهاية هذه. وتغيير المزوّد كثيرًا ما يعني [عنوان URL أساسيًا](https://broadrouter.com/ar/glossary/base-url/) جديدًا ومفتاحًا واسم نموذج جديدين.
-   **التكلفة.** لأن السجل كله يُعاد إرساله، تزداد رموز الإدخال في كل دورة. اختصر المحادثات الطويلة أو لخّصها.
-   **تباين الحقول.** لا يقبل كل المزوّدين المتوافقين كل حقول OpenAI. وقد تُتجاهل الحقول غير المعروفة أو تُرفض، فاختبر الحقول التي تعتمد عليها.

## في BroadNet Inference

يقدّم BroadNet المحادثة عبر POST /v1/chat/completions على `https://inference.broadnet.ai/v1`، لنماذج DeepSeek V4.1 Flash و[GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) و[Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/) و[Gemma 4 VL 26B](https://broadrouter.com/ar/models/gemma-4-vl-26b/). ويستخدم [البث المتدفق](https://broadrouter.com/ar/glossary/streaming/) `stream=true` وينتهي بـ `data: [DONE]`. واستدعاء الأدوات والمخرجات المنظَّمة موثّقان لنموذجي GLM 5.3 وQwen3.8 27B فقط. ولا يوثّق [المرجع التقني لـ BroadNet](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-chat-completions-api&utm_content=body) نقطة نهاية لـ Responses، فاستخدم Chat Completions. ابدأ بـ [البدء السريع مع curl](https://broadrouter.com/ar/guides/curl-quickstart/) أو [دليل Python SDK](https://broadrouter.com/ar/guides/openai-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.

## انظر أيضًا

-   [واجهة API متوافقة مع OpenAI (OpenAI-compatible API)](https://broadrouter.com/ar/glossary/openai-compatible-api/) (مصطلح)
-   [العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/) (مصطلح)
-   [البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/) (مصطلح)
-   [سبب الانتهاء (finish\_reason)](https://broadrouter.com/ar/glossary/finish-reason/) (مصطلح)
-   [استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/) (مصطلح)
-   [أمر النظام (System prompt)](https://broadrouter.com/ar/glossary/system-prompt/) (مصطلح)
-   [رموز الصور (Image tokens)](https://broadrouter.com/ar/glossary/image-tokens/) (مصطلح)
-   [أول طلب إلى BroadNet Inference باستخدام curl](https://broadrouter.com/ar/guides/curl-quickstart/) (دليل)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/) (دليل)
-   [الانتقال من OpenAI API: شرح عملي للشيفرة بـ Python وNode وcURL](https://broadrouter.com/ar/blog/migrate-from-openai-api-code-walkthrough/) (مقال)
-   [الانتقال إلى واجهة API متوافقة مع OpenAI: قائمة تحقق للترحيل](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/) (مقال)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-chat-completions-api&utm_content=page-cta) ·

**المصادر**

-   [مرجع OpenAI API، إنشاء إكمال محادثة (رُوجع في 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI، الانتقال إلى Responses API (رُوجع في 2026-11-15)](https://developers.openai.com/api/docs/guides/migrate-to-responses)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-chat-completions-api&utm_content=sources)
