---
title: "ما هي مهلة الطلب (timeout)؟ المهلات في استدعاءات LLM API"
description: "مهلة الطلب هي المدة التي ينتظرها العميل من LLM API قبل أن يستسلم. مهلة الاتصال ومهلة القراءة، والقيم الافتراضية في SDK، و408 و504، وإعادة المحاولة بأمان."
url: https://broadrouter.com/ar/glossary/request-timeout/
lang: ar
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# مهلة الطلب (Request timeout)

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

مهلة الطلب (request timeout) هي أطول مدة ينتظرها عميل HTTP ردَّ الخادم قبل أن يتخلى عن الطلب. وعادةً يقسمها العملاء إلى مهلة اتصال لفتح الاتصال ومهلة قراءة لانتظار البيانات. وتحتاج استدعاءات LLM إلى مهلات قراءة سخية لأن الإجابات الطويلة تستغرق وقتًا.

يُسمّى أيضًا: مهلة الطلب، مهلة القراءة، مهلة الاتصال، انتهاء المهلة، تايم أوت، request timeout، read timeout، connect timeout، client timeout، HTTP timeout

كل استدعاء عبر الشبكة يحتاج إلى نقطة تتوقف عندها عن الانتظار. وفي استدعاءات LLM يصعب اختيار هذه النقطة، لأن الإجابة البطيئة والاتصال الميت يبدوان متشابهين لبعض الوقت.

## كيف تعمل

تقسم عملاء HTTP الانتظار إلى مراحل. ولدى HTTPX، وهو عميل HTTP شائع في Python، أربع منها:

| المهلة | معناها في HTTPX | الخطأ |
| --- | --- | --- |
| الاتصال (Connect) | أطول مدة لإنشاء اتصال المقبس | `ConnectTimeout` |
| القراءة (Read) | أطول انتظار لجزء من البيانات الواردة | `ReadTimeout` |
| الكتابة (Write) | أطول انتظار لإرسال جزء من جسم الطلب | `WriteTimeout` |
| المجمّع (Pool) | أطول انتظار للحصول على اتصال من المجمّع | `PoolTimeout` |

تنتهي مهلة HTTPX العادي افتراضيًا بعد خمس ثوانٍ من خمول الشبكة. أما OpenAI Python SDK فيضبط قيمته الافتراضية الخاصة: “By default requests time out after 10 minutes” (ترجمة: تنتهي مهلة الطلبات افتراضيًا بعد 10 دقائق)، ويرمي `APITimeoutError`، ويعيد محاولة الطلب الذي انتهت مهلته مرتين. ويعيد أيضًا افتراضيًا محاولة أخطاء الاتصال واستجابات 408 و409 و429 و5xx.

```python
from openai import OpenAI
client = OpenAI(base_url="https://inference.broadnet.ai/v1", timeout=120.0, max_retries=2)
```

وللخوادم مهلات أيضًا. إذ تعرّف MDN الحالة 504 Gateway Timeout بأنها بوابة أو وسيط “did not get a response in time from the upstream server” (ترجمة: لم يتلقَّ استجابة في الوقت المناسب من الخادم الأصلي)، والحالة 408 Request Timeout بأنها رغبة الخادم “to shut down this unused connection” (ترجمة: في إغلاق هذا الاتصال غير المستخدم).

## لماذا تهم

-   **نماذج الاستدلال بطيئة في البدء.** يحدث التفكير قبل أول رمز ظاهر. ومهلة قراءة قصيرة في استدعاء غير متدفق قد تقطع طلبًا سليمًا.
-   **البث يكشف التوقفات.** مع [البث المتدفق](https://broadrouter.com/ar/glossary/streaming/)، يعيد كل جزء ضبط مؤقّت القراءة، فيظهر التوقف سريعًا حتى في إجابة طويلة.
-   **إعادة المحاولة قد تضاعف التكلفة.** انتهاء المهلة لا يعني أن الخادم توقف. وإعادة محاولة طلب لا يزال يعمل قد تُحاسَب مرتين. استخدم [الانتظار الأُسّي](https://broadrouter.com/ar/glossary/exponential-backoff/) مع حد أقصى، و[مفتاح عدم التكرار (idempotency key)](https://broadrouter.com/ar/glossary/idempotency-key/) حيث تدعمه الواجهة.

## في BroadNet Inference

يقول [المرجع التقني لـ BroadNet](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-request-timeout&utm_content=body) أن تقرأ البث حتى `data: [DONE]`. فإن انتهى الاتصال قبلها، “treat the response as incomplete, record the X-Request-ID” (ترجمة: اعتبر الاستجابة ناقصة وسجّل X-Request-ID)، وقرّر هل يستطيع تطبيقك إرسال طلب جديد بأمان. وبالنسبة إلى 500 و502 و503 و504، يوصي بإعادة المحاولة مع انتظار أُسّي محدود؛ أما 429 فتعني بلوغ حد المعدل أو التزامن أو معدل الرموز أو الإنفاق. واحتفظ بـ X-Request-ID للدعم الفني. ويعرض [دليل الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/) و[مقال الوكلاء طويلي التشغيل](https://broadrouter.com/ar/blog/long-running-agents-timeouts-retries/) إعدادات عملية.

## أخطاء شائعة

-   ترك القيمة الافتراضية، ثم التساؤل لماذا يحجز استدعاء معلّق عاملًا لعشر دقائق.
-   إعادة المحاولة دون حد أقصى، فتتحول دقيقة سيئة واحدة إلى سيل من الطلبات.

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

### ما المهلة الافتراضية في OpenAI Python SDK؟

يقول ملف README إن "By default requests time out after 10 minutes" (ترجمة: تنتهي مهلة الطلبات افتراضيًا بعد 10 دقائق)، وتُعاد محاولة الطلبات التي انتهت مهلتها مرتين افتراضيًا مع انتظار أُسّي قصير.

### هل أستخدم مهلة واحدة لكل استدعاءات LLM؟

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

### ماذا أفعل حين يتوقف بث BroadNet مبكرًا؟

تقول BroadNet أن تعتبر البث الذي ينتهي قبل data: \[DONE\] ناقصًا، وأن تسجّل X-Request-ID، وأن تقرّر هل يستطيع تطبيقك إرسال طلب جديد بأمان.

## انظر أيضًا

-   [الانتظار الأُسّي (Exponential backoff)](https://broadrouter.com/ar/glossary/exponential-backoff/) (مصطلح)
-   [البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/) (مصطلح)
-   [زمن الاستجابة (Latency)](https://broadrouter.com/ar/glossary/latency/) (مصطلح)
-   [مفتاح عدم التكرار (Idempotency key)](https://broadrouter.com/ar/glossary/idempotency-key/) (مصطلح)
-   [حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/) (مصطلح)
-   [النموذج الاحتياطي (Model fallback)](https://broadrouter.com/ar/glossary/model-fallback/) (مصطلح)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/) (دليل)
-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/) (دليل)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [الوكلاء طويلو التشغيل: مهلات وإعادة محاولات ونقاط حفظ تصمد](https://broadrouter.com/ar/blog/long-running-agents-timeouts-retries/) (مقال)
-   [كيف تعالج الخطأ 429 في LLM API: الانتظار المتزايد والتذبذب والمحدِّدات](https://broadrouter.com/ar/blog/handle-llm-api-429-rate-limits/) (مقال)

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

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

**المصادر**

-   [ملف README في OpenAI Python SDK، المهلات وإعادة المحاولة (رُوجع في 2026-11-15)](https://github.com/openai/openai-python)
-   [توثيق HTTPX، المهلات (رُوجع في 2026-11-15)](https://www.python-httpx.org/advanced/timeouts/)
-   [MDN، الحالة 504 Gateway Timeout (رُوجع في 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/504)
-   [MDN، الحالة 408 Request Timeout (رُوجع في 2026-11-15)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/408)
-   [المرجع التقني لـ BroadNet Inference API، البث المتدفق والأخطاء (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-request-timeout&utm_content=sources)
