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

# حدود المعدل

> في الدقيقة، لكل بيان اعتماد، ومعلنة في كل استجابة.

| بيان الاعتماد أو الواجهة              | الحد                                               |
| ------------------------------------- | -------------------------------------------------- |
| رمز الوصول الشخصي                     | 1,000 طلب في الدقيقة                               |
| مفتاح API محدود النطاق                | قيمة `rate_limit_rpm` الخاصة به (من 1 إلى 100,000) |
| مسارات الذكاء الاصطناعي تحت `/api/v2` | دفعة من 10، ثم طلب واحد كل ثانيتين                 |

تُحتمل الدفعات القصيرة فوق المعدل الدقيقي حتى نحو سدس الحد.

## الترويسات

تحمل كل استجابة النافذة الحالية:

```
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1712345738
```

`X-RateLimit-Reset` طابع زمني بصيغة Unix.

## عند تجاوز الحد

```
HTTP/1.1 429 Too Many Requests
Retry-After: 60

{ "error": "Rate limit exceeded", "limit": "1000 requests per minute" }
```

انتظر عدد الثواني في `Retry-After`، ثم زد فترة الانتظار أسّيًا إذا تكرر
الأمر. اجمع عمليات القراءة حيثما أمكن: استدعاء قائمة واحد محدود أفضل من
استعلام لكل سجل.

<Tip>
  انقل الأعمال المبنية على الأحداث إلى [Webhooks](/ar/webhooks). الاشتراك لا
  يكلّف أي طلبات.
</Tip>