> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mibyanai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# الأخطاء وإعادة المحاولة

> بنية أخطاء API واستخدام Request ID

تأتي الأخطاء بالشكل التالي:

```json theme={null}
{
  "error": {
    "message": "Human-readable message",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request",
    "request_id": "req_..."
  }
}
```

## متى تعيد المحاولة؟

أعد محاولة `429` و`502` و`503` فقط، مع exponential backoff وjitter. لا تعِد محاولة أخطاء المصادقة أو الصلاحيات أو الطلب غير الصالح دون تغيير المفتاح أو الإعداد أو جسم الطلب.

## رموز شائعة

* `invalid_api_key`, `revoked_api_key`, `expired_api_key`
* `permission_denied`, `model_not_allowed`
* `invalid_request`, `context_length_exceeded`
* `rate_limit_exceeded`, `budget_exceeded`

احتفظ بقيمة `x-request-id` أو `error.request_id` عند التواصل مع الدعم.