---
title: "بث استجابات LLM عبر SSE: المقاطع والاستخدام والإلغاء"
description: "كيف يعمل بث إكمالات المحادثة عبر الشبكة، وكيف تعيد بناء الإجابة من الفروقات، وتقرأ الاستخدام من المقطع الأخير، وتلغي البث بسلاسة في Python وNode وcurl."
url: https://broadrouter.com/ar/blog/llm-streaming-sse-explained/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# شرح البث في LLM: مقاطع SSE والفروقات (delta) والاستخدام والإلغاء

بقلم فريق BroadNet Inference · قراءة في 4 دقائق · تاريخ النشر 2026-11-14 · آخر تحديث 2026-11-16

تبث واجهة LLM API إكمال المحادثة بوصفه أحداث Server-Sent Events: كل سطر data يحمل مقطع JSON يحمل فيه choices\[0\].delta الجزء التالي من النص. اجمع الفروقات، وتوقف عند data: \[DONE\]، واضبط include\_usage في stream\_options لتحصل على أعداد الرموز في مقطع أخير بقائمة choices فارغة. وللإلغاء، أغلق الاتصال.

## أبرز النقاط

-   البث مجرد HTTP عادي: `Content-Type: text/event-stream`، وسطر `data:` واحد لكل مقطع، وسطر فارغ بين الأحداث، و`data: [DONE]` في النهاية.
-   كل مقطع يحمل `delta` لا الرسالة كاملة. اجمع سلاسل `delta.content` لتعيد بناء الإجابة.
-   الاستخدام معطّل افتراضيًا في البث. والإعداد `stream_options: {"include_usage": true}` يضيف مقطعًا أخيرًا فيه الاستخدام ومصفوفة `choices` فارغة.
-   احمِ كل وصول إلى `choices[0]`: فمقطع الاستخدام لا يحتوي على choices، والمحلِّل الذي يفترض وجودها سيتعطل.
-   ألغِ بإغلاق اتصال HTTP. والبث الذي ينتهي دون `[DONE]` إجابة غير مكتملة، لا إجابة منتهية.

**في هذه الصفحة**

1.  كيف يبدو بث SSE على الشبكة؟
2.  ماذا يحتوي المقطع؟
3.  كيف تحصل على استخدام الرموز من البث؟
4.  Python: البث وجمع الاستخدام والإلغاء
5.  Node: البث مع AbortController
6.  curl: رؤية الأحداث الخام
7.  كيف تلغي البث، وكم يكلّف ذلك؟
8.  خمسة أخطاء في البث يجب فحصها
9.  أين تقع BroadNet Inference من هذا؟

دون [البث](https://broadrouter.com/ar/glossary/streaming/)، لا يُعيد إكمال المحادثة أي شيء حتى تكتمل الإجابة كلها. فالرد البالغ 600 رمز بسرعة نحو 100 رمز في الثانية يعني عدة ثوانٍ من الصمت. ومع البث تظهر الكلمات الأولى بمجرد أن يكتبها النموذج. يشرح هذا المقال ما ينتقل فعلًا عبر الشبكة، وكيف تحلّله، وكيف تستخرج استخدام [الرموز](https://broadrouter.com/ar/glossary/token/) من البث، وكيف توقفه بسلاسة. وللاطلاع على قواعد BroadNet الخاصة باختصار، راجع [الدليل المرجعي للبث](https://broadrouter.com/ar/guides/streaming-chat-completions/).

## كيف يبدو بث SSE على الشبكة؟

أحداث Server-Sent Events هي استجابة HTTP عادية بترويسة `Content-Type: text/event-stream`. يُبقي الخادم الاتصال مفتوحًا ويكتب الأحداث. وكل حدث سطر `data:` واحد أو أكثر يليه سطر فارغ. وتضع الواجهات المتوافقة مع OpenAI مقطع JSON واحدًا في كل حدث، وتنتهي بالقيمة الحرفية `[DONE]`:

```text
data: {"id":"c1","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}],"usage":null}

data: {"id":"c1","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"One, "},"finish_reason":null}],"usage":null}

data: {"id":"c1","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"two, three."},"finish_reason":"stop"}],"usage":null}

data: {"id":"c1","object":"chat.completion.chunk","choices":[],"usage":{"prompt_tokens":14,"completion_tokens":6,"total_tokens":20}}

data: [DONE]
```

الشكل أعلاه توضيحي ومختصر. فالمقاطع الحقيقية تحمل أيضًا `model` و`created`، وقد تُبلغ نماذج الاستدلال المنطقي عن رموز الاستدلال ضمن الاستخدام.

## ماذا يحتوي المقطع؟

| الحقل | أين | معناه |
| --- | --- | --- |
| `choices[0].delta.role` | المقطع الأول | عادةً `assistant`. يُرسل مرة واحدة. |
| `choices[0].delta.content` | معظم المقاطع | الجزء التالي من النص. قد يكون فارغًا. |
| `choices[0].delta.tool_calls` | استدعاءات الأدوات | أجزاء من اسم الدالة ووسائط JSON، تُجمع حسب `index`. |
| `choices[0].finish_reason` | آخر مقطع محتوى | `stop` أو `length` أو `tool_calls`. وقيمته `null` قبل ذلك. |
| `usage` | المقطع الأخير، إن طُلب | إجماليات الطلب كله. وقيمته `null` في كل مكان آخر. |

الفكرة الأساسية هي **الفرق (delta) لا اللقطة الكاملة**. فكل مقطع يحمل الجديد فقط، وأنت تعيد بناء الرسالة بجمع الأجزاء بالترتيب. و[استدعاءات الأدوات](https://broadrouter.com/ar/glossary/tool-calling/) تُبث بالطريقة نفسها: تصل الوسائط أجزاءً نصية ليست JSON صالحًا حتى يصل آخرها، فلا تحلّلها إلا بعد أن تصبح قيمة `finish_reason` هي `tool_calls`.

## كيف تحصل على استخدام الرموز من البث؟

الاستجابة غير المتدفقة تتضمن `usage` دائمًا. أما البث فلا، إلا إذا طلبت. اضبط `stream_options: {"include_usage": true}` فيرسل الخادم مقطعًا إضافيًا واحدًا قبل `[DONE]`. يحمل هذا المقطع الإجماليات و**مصفوفة `choices` فارغة**. وعلى BroadNet Inference قد يتضمن الاستخدام أيضًا `prompt_tokens_details.cached_tokens` و`completion_tokens_details.reasoning_tokens` حين يُبلغ النموذج عنهما، وهذا ما تحتاجه [لتسجيل التكلفة](https://broadrouter.com/ar/blog/llm-api-usage-logging/).

والخطأ الشائع: الشيفرة التي تقرأ `chunk.choices[0]` في كل مقطع تُطلق خطأ فهرس عند مقطع الاستخدام. افحص `choices` أولًا.

## Python: البث وجمع الاستخدام والإلغاء

```python
import os
from openai import OpenAI

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])

stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash",  # DeepSeek V4.1 Flash, a reasoning model
    messages=[{"role": "user", "content": "Explain SSE in three sentences."}],
    stream=True,
    stream_options={"include_usage": True},
    max_tokens=2000,  # reasoning counts toward this limit
)

def user_pressed_stop():  # replace with your own condition
    return False

parts, usage, finish = [], None, None
try:
    for chunk in stream:
        if chunk.choices:
            choice = chunk.choices[0]
            if choice.delta.content:
                parts.append(choice.delta.content)
                print(choice.delta.content, end="", flush=True)
            if choice.finish_reason:
                finish = choice.finish_reason
        if chunk.usage:
            usage = chunk.usage
        if user_pressed_stop():  # your own condition
            break
finally:
    stream.close()  # closes the HTTP connection

text = "".join(parts)
```

الأمر `break` وحده يوقف القراءة، لكن المقبس (socket) يبقى مفتوحًا حتى يجمعه جامع المهملات. أغلقه صراحةً ليرى الخادم انقطاع الاتصال.

## Node: البث مع AbortController

```javascript
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });
const controller = new AbortController();
setTimeout(() => controller.abort(), 30_000); // hard stop after 30 s

const stream = await client.chat.completions.create(
  {
    model: "broadnet/deepseek-v4.1-flash",
    messages: [{ role: "user", content: "Explain SSE in three sentences." }],
    stream: true,
    stream_options: { include_usage: true },
  },
  { signal: controller.signal },
);

let text = "";
for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content;
  if (delta) text += delta;
  if (chunk.usage) console.log(chunk.usage);
}
```

يوثّق [ملف README لمكتبة openai-node](https://github.com/openai/openai-node) الخيار `signal`، وهو يعمل أثناء قراءة جسم الاستجابة أيضًا. وفي خادم ويب، اربط `controller.abort()` بحدث `close` لطلب العميل، حتى يوقف المستخدم الذي يغادر الصفحة التوليدَ أيضًا. ومزيد من الإعداد في [دليل Node SDK](https://broadrouter.com/ar/guides/openai-node-sdk/).

## curl: رؤية الأحداث الخام

```bash
curl -N 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","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count to five."}]}'
```

الخيار `-N` يعطّل التخزين المؤقت للمخرجات فتُطبع الأحداث فور وصولها. اضغط Ctrl+C للإلغاء؛ فهذا يغلق الاتصال. و[منشئ طلبات API](https://broadrouter.com/tools/api-request-builder/) يولّد هذا الطلب، ونسختيه بـ Python وNode، لأي نموذج وعنوان أساسي (base URL).

## كيف تلغي البث، وكم يكلّف ذلك؟

الإلغاء في SSE مجرد إغلاق للاتصال، فلا توجد رسالة «توقف». وما يحدث بعد ذلك يعود إلى الخادم: فالخادم المنضبط يلاحظ المقبس المغلق ويتوقف عن التوليد. والرموز المنتَجة قبل تلك اللحظة عمل حقيقي. ولا يوثّق المرجع التقني لواجهة BroadNet احتساب البث الملغى، فخطّط على أساس أن الرموز المولّدة حتى الانقطاع تُحتسب في [الدفع حسب الاستخدام](https://broadrouter.com/ar/glossary/pay-as-you-go/)، وراجع سجلات استخدامك. وفي الخطة الثابتة لا يكلّف البث الملغى شيئًا إضافيًا، لكنه لا يحرّر الجلسة إلا حين يتوقف الخادم.

## خمسة أخطاء في البث يجب فحصها

1.  **الوكلاء الذين يخزّنون الاستجابات مؤقتًا.** Nginx وبعض شبكات CDN تخزّن الاستجابات مؤقتًا، فيستلم العميل كل شيء دفعة واحدة. عطّل التخزين المؤقت في الوكيل لمسار البث.
2.  **غياب فحص `[DONE]`.** الاتصال المنقطع يبدو إجابة قصيرة. اعتبر غياب `[DONE]` إجابة غير مكتملة وسجّل `X-Request-ID`، كما يصف [دليل الأخطاء](https://broadrouter.com/ar/guides/errors-and-retries/).
3.  **إعادة المحاولة في منتصف البث.** حزم SDK لا تعيد المحاولة بعد أن يبدأ جسم الاستجابة بالوصول. وإعادة المحاولة طلب جديد، وفي الدفع حسب الاستخدام فاتورة جديدة.
4.  **تجاهل `finish_reason: length`.** في نماذج الاستدلال المنطقي مثل [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) يُحتسب التفكير ضمن [max\_tokens](https://broadrouter.com/ar/glossary/max-tokens/)، فقد يوقف الحد الصغير البث قبل ظهور أي نص مرئي. راجع [ما تكلّفه رموز الاستدلال المنطقي](https://broadrouter.com/ar/blog/reasoning-tokens-cost/).
5.  **تقسيم الأسطر بطريقة خاطئة.** إن كنت تحلّل SSE يدويًا، فخزّن البايتات حتى ترى سطرًا فارغًا. فقراءة TCP قد تنتهي في منتصف مقطع JSON.

## أين تقع BroadNet Inference من هذا؟

تستخدم BroadNet Inference شكل البث القياسي [المتوافق مع OpenAI](https://broadrouter.com/ar/glossary/openai-compatible-api/)، فتحلّله حزمتا Python وNode دون تعديل. ويتضمن الاستخدام في المقطع الأخير الرموز المخزّنة مؤقتًا ورموز الاستدلال المنطقي حين يُبلغ النموذج عنها. وتقول وثائقها إنه يجب التحقق من البث لكل نموذج قبل الاستخدام في بيئة الإنتاج، فشغّل الشيفرة أعلاه على النموذج نفسه الذي تطلقه. وإن كان أكثر ما يهمك هو سرعة وصول الرمز الأول، فاقرأ بعد ذلك [TTFT مقابل الإنتاجية](https://broadrouter.com/ar/blog/llm-latency-ttft-throughput/). وإن كنت تحتاج إلى صوت فوري عبر WebSockets، فهذه الواجهة ليست مصمّمة لذلك؛ فهي تقدّم إكمالات المحادثة وتفريغ الملفات الصوتية.

أدوات مجانية لهذا الموضوع (بالإنجليزية)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[أدوات مجانية (بالإنجليزية)](https://broadrouter.com/tools/)

## مصطلحات في هذا المقال

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[الأحداث التي يرسلها الخادم (SSE)](https://broadrouter.com/ar/glossary/sse/)

الأحداث التي يرسلها الخادم (server-sent events أو SSE) معيار ويب يتيح للخادم دفع تدفق من الأحداث النصية إلى العميل عبر استجابة HTTP واحدة طويلة الأمد بنوع المحتوى text/event-stream. وكل حدث سطر حقل أو أكثر، مثل data:، ينتهي بسطر فارغ.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/)

البث المتدفق (streaming) طريقة لإرجاع استجابة النموذج اللغوي على أجزاء صغيرة أثناء توليدها، بدل إرجاعها ردًا واحدًا في النهاية. وتبث الواجهات المتوافقة مع OpenAI عبر أحداث يرسلها الخادم (server-sent events) حين يضبط الطلب stream على true.

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

[الإنتاجية (Throughput)](https://broadrouter.com/ar/glossary/throughput/)

الإنتاجية (throughput) في تقديم نماذج LLM هي إجمالي العمل الذي ينجزه النظام في وحدة الزمن عبر كل الطلبات المتزامنة، وتُقاس عادةً برموز الإخراج في الثانية أو الطلبات في الثانية. وهي تختلف عن سرعة التدفق الواحد، أي مدى سرعة وصول الرموز إلى طلب واحد.

[الذكاء الاصطناعي متعدد الوسائط (Multimodal AI)](https://broadrouter.com/ar/glossary/multimodal/)

الذكاء الاصطناعي متعدد الوسائط هو نموذج أو نظام يتعامل مع أكثر من نوع من البيانات، مثل النص والصور والفيديو والصوت. فقد يقرأ النموذج متعدد الوسائط صورة وسؤالًا معًا، أو يستقبل كلامًا ويجيب نصًا. والنموذج اللغوي البصري هو أشهر أنواعه.

## أسئلة شائعة

### ما الفرق بين SSE وWebSockets في بث استجابات LLM؟

SSE اتجاه واحد، من الخادم إلى العميل، عبر استجابة HTTP عادية. وهذا كل ما يحتاجه إكمال المحادثة، لذلك تستخدم الواجهات المتوافقة مع OpenAI تقنية SSE. أما WebSockets فثنائية الاتجاه وتحتاج إلى ترقية البروتوكول؛ وتُستخدم للصوت الفوري، لا لإكمالات المحادثة.

### لماذا قيمة usage فارغة (null) في مقاطع البث لدي؟

لا يُرسل الاستخدام إلا إذا طلبته. أضف stream\_options مع ضبط include\_usage على true. عندها تكون قيمة usage فارغة في كل مقطع ما عدا الأخير، ويحمل المقطع الأخير الإجماليات مع قائمة choices فارغة.

### هل أدفع إذا ألغيت البث؟

يختلف المزوّدون، وكثير منهم لا يوثّق ذلك. افترض أن الرموز المولّدة قبل أن يلاحظ الخادم إغلاق الاتصال تُحتسب. سجّل X-Request-ID وقارنه بسجلات استخدامك.

### كيف أعرف أن البث انتهى بشكل طبيعي؟

إذا استلمت data: \[DONE\] وكان لآخر مقطع محتوى finish\_reason مثل stop. أما finish\_reason بقيمة length فتعني أن max\_tokens قطعت الإجابة. وغياب \[DONE\] يعني أن الاتصال انقطع.

### هل يجعل البث النموذج أسرع؟

لا. إجمالي زمن التوليد هو نفسه. لكن البث يقلّل الوقت حتى يرى المستخدم الكلمات الأولى، وهذا ما يجعل واجهة المحادثة تبدو سريعة.

## تابع القراءة

-   [زمن استجابة LLM: زمن أول رمز مقابل الرموز في الثانية والزمن الكلي](https://broadrouter.com/ar/blog/llm-latency-ttft-throughput/)
-   [تسجيل استخدام LLM API: التكلفة لكل مستخدم وميزة وحجب البيانات](https://broadrouter.com/ar/blog/llm-api-usage-logging/)
-   [كيف تعالج الخطأ 429 في LLM API: الانتظار المتزايد والتذبذب والمحدِّدات](https://broadrouter.com/ar/blog/handle-llm-api-429-rate-limits/)
-   [عتاد GPU لدى BroadNet وطريقة تقديم النماذج، كما تصفها BroadNet](https://broadrouter.com/ar/blog/broadnet-gpu-fleet-and-serving/)
-   [تخزين استجابات LLM API مؤقتًا لخفض التكلفة: تطابق تام بـ Python](https://broadrouter.com/ar/blog/cache-llm-responses-cut-cost/)
-   [دليل: البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [دليل: استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [دليل: استخدام OpenAI Node.js SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-node-sdk/)
-   [دليل: رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)

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

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-llm-streaming-sse-explained&utm_content=page-cta) ·

**المصادر**

-   [المرجع التقني لواجهة BroadNet Inference، البث والاستخدام (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-llm-streaming-sse-explained&utm_content=sources#requests)
-   [MDN، استخدام أحداث Server-Sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events)
-   [إعلان مجتمع OpenAI، إحصاءات الاستخدام في البث (stream\_options)](https://community.openai.com/t/usage-stats-now-available-when-using-streaming-with-the-chat-completions-api-or-completions-api/738156)
-   [ملف README لمكتبة openai-python، الاستجابات المتدفقة وإعادة المحاولة (تاريخ المراجعة 2026-11-14)](https://github.com/openai/openai-python)
-   [ملف README لمكتبة openai-node، الإلغاء عبر AbortSignal (تاريخ المراجعة 2026-11-14)](https://github.com/openai/openai-node)
