---
title: "أخطاء LLM API 401 و402 و409 و429: متى تعيد المحاولة؟"
description: "ماذا يعني كل رمز حالة HTTP من BroadNet Inference API، وأيها تعيد محاولته مع انتظار متزايد، وأيها تصلحه أولًا، وماذا ترسل إلى الدعم مع معرّف الطلب."
url: https://broadrouter.com/ar/guides/errors-and-retries/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# رموز أخطاء BroadNet Inference ومتى تعيد المحاولة

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

افحص رمز حالة HTTP قبل تحليل جسم الاستجابة. أعد محاولة 429 و5xx مع انتظار أُسّي (exponential backoff) له حد أقصى. أصلح 400 و403 و413 و422 قبل إعادة المحاولة. وعند 401 تحقّق من المفتاح والرصيد، وعند 402 موّل الحساب. وسجّل دائمًا الترويسة X-Request-ID من أجل الدعم.

تُرجع الواجهة رمز حالة HTTP عاديًا ورمز خطأ قابلًا للقراءة آليًا. اختر خطوتك التالية بناءً على رمز الحالة. يتبع هذا الجدول [المرجع التقني](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-errors-and-retries&utm_content=body#errors) لدى BroadNet.

| رمز الحالة | المعنى | ما العمل |
| --- | --- | --- |
| 400 / 422 | طلب أو حقل غير صالح | أصلح الطلب أولًا |
| 401 | مفتاح مفقود أو غير صالح أو منتهي الصلاحية، أو ميزانية دفع حسب الاستخدام محظورة، أو حصة مستنفدة | تحقّق من حالة المفتاح ورصيد الحساب |
| 402 `insufficient_balance` | لا يكفي رصيد الحساب لعملية شراء؛ يتضمّن الجسم الرصيد والسعر | موّل الحساب، ثم أعد المحاولة |
| 403 | رفضته سياسة النموذج أو المسار أو عناوين IP | أصلح عدم التطابق، مثل [قائمة عناوين IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/) |
| 409 | تعارض مع حالة الحساب: `mint_in_progress` أو `key_limit_reached` أو `credential_limit_reached` أو `key_pending` | أعد المحاولة في حالة `mint_in_progress` فقط، وبنفس `request_id` |
| 413 | الطلب كبير جدًا؛ الحد الأقصى لملفات التفريغ الصوتي 26,214,400 بايت | صغّر الطلب |
| 429 | بلوغ حد المعدل أو التزامن أو معدل الرموز أو الإنفاق | اقرأ تفاصيل الاستجابة، وانتظر مدة متزايدة، ثم أعد المحاولة |
| 500 / 502 / 503 / 504 | معالجة من جهة الخادم | أعد المحاولة مع انتظار أُسّي له حد أقصى؛ واستخدم نفس `request_id` عند شراء المفاتيح بالساعة |

تنص وثائق BroadNet على فحص رمز حالة HTTP قبل تحليل جسم JSON، ثم قراءة رمز `error` القابل للقراءة آليًا حيثما وُجد.

## ما الحدود التي تسبّب الخطأ 429؟

يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات قيد التنفيذ في آنٍ واحد. وتمنح وثائق BroadNet المفتاح بالساعة 120 من الطلبات في الدقيقة وتدفقًا واحدًا و300,000 من الرموز (التوكنات) في الدقيقة. أما في [الخطة غير المحدودة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)، فكل جلسة تنفّذ طلبًا واحدًا في كل مرة. ولمقارنة هذه الحدود بحدود OpenAI وAnthropic وGroq وDeepSeek، اقرأ [حدود معدل LLM API لدى كل مزوّد](https://broadrouter.com/ar/blog/llm-api-rate-limits-by-provider/).

## كيف أعيد المحاولة باستخدام OpenAI SDK؟

تعيد حزمة OpenAI Python SDK بالفعل محاولة أخطاء الاتصال واستجابات 408 و409 و429 و5xx مرتين افتراضيًا، مع انتظار أُسّي قصير، بحسب [ملف README على GitHub](https://github.com/openai/openai-python#retries). ومهلتها الافتراضية 10 دقائق. اضبط القيمتين صراحةً:

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_retries=4,   # 0 turns automatic retries off
    timeout=120,     # seconds; raise it for long reasoning answers
)
```

## كيف أكتب آلية انتظار خاصة بي؟

إذا استدعيت الواجهة دون حزمة SDK، فضع حدًا أقصى لعدد المحاولات ولمدة الانتظار معًا:

```python
import random, time, requests

RETRY = {429, 500, 502, 503, 504}

def post_with_backoff(url, headers, body, tries=5):
    for attempt in range(tries):
        r = requests.post(url, headers=headers, json=body, timeout=120)
        if r.status_code not in RETRY:
            return r                      # success, or an error to fix rather than retry
        time.sleep(min(30, 2 ** attempt) + random.random())
    return r
```

لا تُعد أبدًا محاولة 400 أو 403 أو 413 أو 422 دون تعديل: الطلب نفسه سيفشل بالطريقة نفسها. وكل إعادة لطلب محادثة هي عملية استدلال جديدة تُحتسب مرة أخرى في الدفع حسب الاستخدام. راجع [الانتظار الأُسّي (exponential backoff)](https://broadrouter.com/ar/glossary/exponential-backoff/) للنمط العام.

## إعادة محاولة شراء مفتاح بالساعة بأمان

يقبل `POST /portal/keys/hourly` قيمة `request_id`. بعد انتهاء المهلة، أو انقطاع الاتصال، أو الخطأ 409 `mint_in_progress`، أو 5xx، أعد المحاولة **بنفس** `request_id`. لا يؤدي تكرار `request_id` أبدًا إلى إنشاء مفتاح ثانٍ أو تحصيل ثمنه؛ بل يُرجع التكرار `already_issued: true` والاسم المستعار للمفتاح. ولا تولّد معرّفًا جديدًا أبدًا قبل أن تعرف نتيجة الطلب الأول. المزيد عن [مفاتيح منع التكرار (idempotency keys)](https://broadrouter.com/ar/glossary/idempotency-key/).

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

-   **401 مباشرة بعد شحن الرصيد.** تعرض صفحة الحساب في BroadNet آخر حصة مسجّلة، وتَسِم أي تغيير في التمويل بأنه قيد التحديث أثناء تطبيقه. حدّث الصفحة وأعد المحاولة بعد اكتماله.
-   **429 مع طلبات قليلة في الدقيقة.** الأرجح أنك تصطدم بحد التزامن البالغ 4 من الطلبات، مثلًا مع عمليات بث طويلة تعمل بالتوازي. استخدم مجموعة عمّال (worker pool) صغيرة.
-   **403 على نموذج دون آخر.** سياسة المفتاح لا تغطي ذلك النموذج أو المسار. فمفاتيح الخطط مثلًا مخصّصة لـ `broadnet/deepseek-v4.1-flash`، والمفتاح بالساعة لا يغطي إلا `broadnet/gemma-4-26b-a4b`.
-   **أعادت حزمة SDK المحاولة فدفعت مرتين.** طلب المحادثة المعاد هو عملية استدلال جديدة. اضبط `max_retries=0` حيث تكون الإجابة المكرّرة أعلى كلفة من الطلب الفاشل.

## ماذا ترسل إلى الدعم

أرفق قيمة الترويسة `X-Request-ID`، والطابع الزمني بتوقيت UTC، والمسار، ورمز حالة HTTP، والاسم المستعار لمفتاحك. ولا ترسل المفتاح نفسه أبدًا. يوضّح [دليل OpenAI Python SDK](https://broadrouter.com/ar/guides/openai-python-sdk/) كيف تقرأ هذه الترويسة.

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

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

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

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

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

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

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

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

[الانتظار الأُسّي (Exponential backoff)](https://broadrouter.com/ar/glossary/exponential-backoff/)

الانتظار الأُسّي (exponential backoff) استراتيجية لإعادة المحاولة ينتظر فيها العميل مدة أطول بعد كل محاولة فاشلة، وعادةً يضاعف التأخير حتى حد أقصى، قبل أن يحاول مجددًا. وإضافة تذبذب عشوائي (jitter) إلى كل انتظار توزّع محاولات العملاء الكثيرين كي لا تصل إلى الخادم في اللحظة نفسها.

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[مفتاح عدم التكرار (Idempotency key)](https://broadrouter.com/ar/glossary/idempotency-key/)

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

[تحويل الصوت إلى نص (Speech-to-text)](https://broadrouter.com/ar/glossary/speech-to-text/)

تحويل الكلام إلى نص، ويسمّى أيضًا التعرّف التلقائي على الكلام (ASR)، هو تقنية تحوّل الصوت المنطوق إلى نص مكتوب. تستقبل واجهة تحويل الصوت إلى نص ملفًا صوتيًا أو بثًا وتُرجع نصًا مفرّغًا، يُسعَّر عادةً لكل دقيقة صوت. وتُقاس الدقة بمعدل الخطأ في الكلمات، وتتفاوت بحسب اللكنة واللهجة وجودة التسجيل.

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

### هل أعيد المحاولة عند ظهور الخطأ 429 من LLM API؟

نعم، مع انتظار أُسّي له حد أقصى. يعني الخطأ 429 في BroadNet Inference بلوغ حد المعدل أو التزامن أو معدل الرموز أو الإنفاق. قلّل التوازي إذا تكرّر، وتوقّف عن إعادة المحاولة متى كان حد الإنفاق هو السبب.

### لماذا يظهر لي الخطأ 401 مع أن مفتاحي صحيح؟

في BroadNet يشمل الخطأ 401 أيضًا استنفاد حصة الدفع حسب الاستخدام أو حظر الميزانية، لا المفتاح الخاطئ أو المنتهي فقط. تحقّق من رصيد الحساب وحالة المفتاح في صفحة الحساب.

### ما الفرق بين 401 و403 هنا؟

يتعلق الخطأ 401 بالمفتاح أو بحصة الحساب. أما 403 فيعني أن المفتاح يعمل لكن سياسة النموذج أو المسار أو عناوين IP رفضت الطلب، كاستدعاء من عنوان غير مدرج في قائمة العناوين المسموح بها.

### هل تعيد حزمة OpenAI SDK محاولة الأخطاء تلقائيًا؟

نعم. تعيد حزمة OpenAI Python SDK محاولة أخطاء الاتصال و408 و409 و429 و5xx مرتين افتراضيًا مع انتظار أُسّي قصير. اضبط max\_retries لتغيير العدد، أو على 0 لإيقاف إعادة المحاولة.

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

-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [اربط مفاتيح API بخوادمك عبر قوائم عناوين IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)

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

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

**المصادر**

-   [المرجع التقني لـ BroadNet Inference API، الأخطاء وإعادة المحاولة (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-errors-and-retries&utm_content=sources#errors)
-   [المرجع التقني لـ BroadNet Inference API، الحدود (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-errors-and-retries&utm_content=sources#limits)
-   [ملف README لـ OpenAI Python SDK: إعادة المحاولة والمهلات (رُوجع في 2026-11-14)](https://github.com/openai/openai-python#retries)
