---
title: "بث ردود LLM عبر SSE مع الاستهلاك وإعادة المحاولة | BroadRouter"
description: "كيف يعمل البث المتدفق في BroadNet Inference: أحداث Server-Sent Events، وعلامة [DONE]، واستهلاك الرموز في آخر جزء، وما العمل حين ينتهي البث مبكرًا."
url: https://broadrouter.com/ar/guides/streaming-chat-completions/
lang: ar
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال

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

اضبط stream على true في /v1/chat/completions، واقرأ أحداث Server-Sent Events حتى العلامة الحرفية data: \[DONE\]. أضف stream\_options include\_usage لتحصل على أعداد الرموز (التوكنات) في آخر جزء. وإذا انقطع الاتصال قبل \[DONE\]، فاعتبر الإجابة غير مكتملة وسجّل X-Request-ID.

يتيح البث المتدفق لوكيل أو لواجهة محادثة عرض الإجابة أثناء توليدها. يستخدم BroadNet Inference صيغة البث القياسية لإكمال المحادثات، لذا تتولى [OpenAI Python SDK](https://broadrouter.com/ar/guides/openai-python-sdk/) و[OpenAI Node SDK](https://broadrouter.com/ar/guides/openai-node-sdk/) التحليل نيابةً عنك.

## باستخدام curl

```bash
curl -N -D stream-headers.txt 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 from one to three."}]}'
```

يوقف الخيار `-N` التخزين المؤقت في curl، ويحفظ `-D` الترويسات، ومنها `X-Request-ID`.

## كيف يبدو البث؟

الاستجابة بث من نوع [Server-Sent Events](https://broadrouter.com/ar/glossary/sse/). بحسب معيار WHATWG HTML، يتكوّن كل حدث من سطر `data:` واحد أو أكثر يليه سطر فارغ، والسطر الذي يبدأ بنقطتين رأسيتين تعليق يمكنك تجاهله. يحمل كل سطر `data:` جزءًا واحدًا بصيغة JSON، ويصل النص في `choices[0].delta.content`.

## القواعد

1.  اقرأ الأحداث حتى السطر الحرفي `data: [DONE]`، ثم أغلق القارئ.
2.  مع `stream_options: {"include_usage": true}` يصل جزء إضافي واحد قبل `[DONE]` مباشرة. يحمل `usage` للطلب كله وقائمة `choices` فارغة، فتحقّق من `choices` قبل الوصول إلى عناصرها بالفهرس.
3.  حين يُبلغ النموذج عنها، يتضمّن هذا الاستهلاك `completion_tokens_details.reasoning_tokens` (تُجري نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B استدلالًا منطقيًا أولًا) و`prompt_tokens_details.cached_tokens`. وتُحتسب الرموز المخزّنة مؤقتًا بسعر الإدخال المخزّن مؤقتًا الأقل.

## باستخدام Python SDK

```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/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Count from one to three."}],
    stream=True,
    stream_options={"include_usage": True},
)
usage = None
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        usage = chunk.usage
print()
print(usage)  # None means the stream ended before the usage chunk
```

تقرأ حزمة SDK حتى `[DONE]` نيابةً عنك. ويعرض [دليل OpenAI Node SDK](https://broadrouter.com/ar/guides/openai-node-sdk/) الحلقة نفسها بلغة JavaScript.

## حين ينتهي البث مبكرًا

إذا أُغلق الاتصال قبل `[DONE]`، فالإجابة غير مكتملة. توجيهات BroadNet:

-   سجّل `X-Request-ID`؛
-   قرّر ما إذا كان تطبيقك يستطيع بأمان إرسال طلب **جديد**. إعادة المحاولة عملية استدلال جديدة تُحتسب مرة أخرى في الدفع حسب الاستخدام.

وللوكلاء على [خطة غير محدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)، لا تكلّف إعادة المحاولة شيئًا إضافيًا، لكنها تظل تشغل الجلسة طوال تنفيذها.

تقول وثائق BroadNet إن التحقق من كل نموذج عند إصداره لا يزال مطلوبًا قبل الاعتماد على البث المتدفق في الإنتاج، فاختبره على النموذج الذي ستطلق به منتجك.

## حل المشكلات

-   **يُطبع كل شيء في النهاية.** يحتاج curl إلى `-N`. وخلف وكيل (proxy) خاص بك، أوقف التخزين المؤقت للاستجابات من نوع `text/event-stream`.
-   **`IndexError` أو `undefined` في آخر جزء.** جزء الاستهلاك فيه قائمة `choices` فارغة. تحقّق من `chunk.choices` قبل قراءة `[0]`.
-   **لا يوجد استهلاك على الإطلاق.** لم ترسل `stream_options`، أو انقطع البث قبل الجزء الأخير.
-   **يتوقف البث مع `finish_reason` بقيمة `length` ونص قليل.** أنفق نموذج استدلال منطقي `max_tokens` على الاستدلال. راجع [لماذا تُرجع نماذج الاستدلال المنطقي إجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429 أثناء البث المتوازي.** كل بث مفتوح يُحتسب طلبًا قيد التنفيذ؛ ويسمح مفتاح الدفع حسب الاستخدام بـ 4 منها. راجع [رموز أخطاء BroadNet وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

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

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

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

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

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

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

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

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

[خطة LLM API بسعر ثابت (Flat-rate LLM plan)](https://broadrouter.com/ar/glossary/flat-rate-llm-plan/)

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

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

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

أرسل stream\_options مع ضبط include\_usage على true. يصل جزء إضافي واحد قبل data: \[DONE\] مباشرة، وفيه usage مملوء ومصفوفة choices فارغة. وإذا انقطع البث قبله، فلن يصل هذا الجزء.

### لماذا يطبع curl الإجابة المتدفقة كلها دفعة واحدة؟

يخزّن curl مخرجاته مؤقتًا افتراضيًا. أضف الخيار -N (بلا تخزين مؤقت) لكي يُطبع كل حدث من أحداث Server-Sent Events فور وصوله.

### هل يُحتسب البث المُعاد مرتين؟

نعم في الدفع حسب الاستخدام، لأن إعادة المحاولة طلب استدلال جديد. أما في خطة DeepSeek V4.1 Flash غير المحدودة فلا يوجد عدّاد للرموز، لكن إعادة المحاولة تظل تشغل الجلسة طوال تنفيذها.

### هل يكلّف البث المتدفق أكثر من الطلب العادي؟

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

## أدلة ذات صلة

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)

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

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

**المصادر**

-   [المرجع التقني لـ BroadNet Inference API، البث المتدفق (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-streaming-chat-completions&utm_content=sources#requests)
-   [معيار WHATWG HTML، أحداث server-sent events (رُوجع في 2026-11-14)](https://html.spec.whatwg.org/multipage/server-sent-events.html)
-   [OpenAI Python SDK، التوثيق المضمّن لـ stream\_options include\_usage (رُوجع في 2026-11-14)](https://github.com/openai/openai-python/blob/main/src/openai/types/chat/chat_completion_stream_options_param.py)
