> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-de47a659.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# حدود المعدل

> حدود معدل Venice API حسب المستوى، والرؤوس التي تكشف السعة، والتعامل مع أخطاء 429.

تختلف حدود المعدل حسب النموذج والمستوى. الحدود الافتراضية أدناه مرجع مفيد، لكن endpoint API `/api_keys/rate_limits` هي الطريقة الرسمية لجلب حدودك الحالية. يمكنك التحقق من حدودك الدقيقة في أي وقت:

<CardGroup cols={2}>
  <Card title="عرض حدودك" icon="gauge-high" href="/ar/api-reference/endpoint/api_keys/rate_limits?playground=open">
    ساحة لعب تفاعلية
  </Card>

  <Card title="سجلات حدود المعدل" icon="clock-rotate-left" href="/ar/api-reference/endpoint/api_keys/rate_limit_logs?playground=open">
    شاهد الطلبات التي وصلت إلى الحدود
  </Card>
</CardGroup>

```bash theme={null}
curl https://api.venice.ai/api/v1/api_keys/rate_limits \
  -H "Authorization: Bearer $VENICE_API_KEY"
```

## الحدود الافتراضية

### نماذج النصوص والـ Embedding

تُجمَّع نماذج النصوص والـ embedding في أربعة أحجام. تعرض كل بطاقة نموذج في [صفحة النماذج](/ar/models/text) شارة حجمها. جميع نماذج الـ embedding من الحجم XS.

| الحجم | طلبات/دقيقة | Tokens/دقيقة | طلبات الشريك/دقيقة | Tokens الشريك/دقيقة |
| :---- | ----------: | -----------: | -----------------: | ------------------: |
| XS    |         500 |    5,000,000 |                500 |          10,000,000 |
| S     |         150 |    3,000,000 |                300 |           6,000,000 |
| M     |         100 |    2,000,000 |                200 |           4,000,000 |
| L     |         100 |    2,000,000 |                150 |           3,000,000 |

<Note>
  تعمل بعض النماذج على بنية تحتية مخصصة أو تابعة لطرف ثالث وتحمل حدودًا لا تتطابق مع هذه الأحجام الأربعة. استدعِ [`GET /api_keys/rate_limits`](/ar/api-reference/endpoint/api_keys/rate_limits) للحصول على الحدود الرسمية لكل نموذج على مفتاحك.
</Note>

### نماذج الصور والصوت

| النوع                           | طلبات/دقيقة | طلبات الشريك/دقيقة |
| :------------------------------ | ----------: | -----------------: |
| الصور والـ upscale والـ inpaint |          20 |                 60 |
| الكلام والتفريغ الصوتي          |          60 |                120 |

### نماذج الفيديو والموسيقى

توليد الفيديو والموسيقى غير خاضع لحدود المعدل. تُحتسب فوترة كليهما لكل عملية توليد من رصيدك، لذا فإن القيد العملي هو التكلفة وليس سقف الطلبات. قم بتسعير المهمة أولًا باستخدام [`POST /video/quote`](/ar/api-reference/endpoint/video/quote) أو [`POST /audio/quote`](/ar/api-reference/endpoint/audio/quote).

## التعامل مع الأخطاء

يجب إعادة محاولة الطلبات الفاشلة (500، 503، 429) باستخدام exponential backoff.

بالنسبة لأخطاء 429 تحديدًا، تحقق من header `x-ratelimit-reset-requests` للحصول على الطابع الزمني Unix الدقيق متى يمكنك إعادة المحاولة. تحتوي معظم مكتبات HTTP على آليات إعادة محاولة مدمجة تتعامل مع هذا تلقائيًا.

### ميزانيات الأخطاء

يحمي حدّان إضافيان الـ API من العملاء الذين يستمرون في إعادة المحاولة دون جدوى. يُحسب كلاهما لكل نموذج ولكل مفتاح API خلال نافذة متحركة مدتها 30 ثانية، ويعيد كلاهما `429`:

| الميزانية                  |           العتبة | ينطبق على                         |
| :------------------------- | ---------------: | :-------------------------------- |
| الطلبات الفاشلة            |  50 لكل 30 ثانية | جميع الـ endpoints                |
| طلبات الميزات غير المدعومة | 200 لكل 30 ثانية | `/chat/completions`، `/responses` |

تحسب الميزانية الثانية الطلبات التي تطلب من نموذج ميزة لا يدعمها. على سبيل المثال، طلب الرؤية أو استدعاء الأدوات من نموذج لا يمتلك تلك القدرة. يظهر تجاوز أي من الميزانيتين في [سجلات حدود المعدل](/ar/api-reference/endpoint/api_keys/rate_limit_logs) باسم `FAILED_REQUESTS` أو `UNSUPPORTED_FEATURE_REQUESTS`.

يعيد كلاهما `customMessage` يحدد العتبة التي تم تجاوزها:

```
Too many failed attempts (> 50) resulting in a non-success status code. Please wait 30 seconds and try again. See https://docs.venice.ai/api-reference/rate-limiting for more information.
```

تعيّن هذه الاستجابات `x-ratelimit-remaining` و`x-ratelimit-resets` بدلًا من رؤوس النافذة المذكورة أدناه.

## رؤوس الاستجابة

تتضمن كل استجابة هذه الرؤوس:

| Header                           | الوصف                                              |
| :------------------------------- | :------------------------------------------------- |
| `x-ratelimit-limit-requests`     | الحد الأقصى للطلبات المسموح بها في النافذة الحالية |
| `x-ratelimit-remaining-requests` | الطلبات المتبقية في النافذة الحالية                |
| `x-ratelimit-reset-requests`     | طابع Unix الزمني عند إعادة تعيين النافذة           |
| `x-ratelimit-limit-tokens`       | الحد الأقصى لـ tokens المسموح به في الدقيقة        |
| `x-ratelimit-remaining-tokens`   | الـ tokens المتبقية في الدقيقة الحالية             |
| `x-ratelimit-reset-tokens`       | الثواني حتى إعادة تعيين حد الـ tokens              |

يستخدم endpoint `/crypto/rpc/{network}` حدوده الخاصة ورؤوسه الخاصة `X-RateLimit-Limit` و`X-RateLimit-Remaining` و`X-RateLimit-Reset`، والتي تُعيَّن فقط في استجابات 429. راجع [Crypto RPC](/ar/api-reference/endpoint/crypto/rpc) لمزيد من التفاصيل.

## مستوى الشريك

حدود الشريك مدرجة إلى جانب الحدود الافتراضية في الجداول أعلاه.

إذا كنت تصل باستمرار إلى حدود المعدل وتُظهِر أنماط استخدامك **طلبًا مستمرًا عبر الزمن**، تواصل لمناقشة الوصول كشريك: [api@venice.ai](mailto:api@venice.ai).

يمكن تعديل حدود مستوى الشريك بناءً على احتياجاتك المحددة.