حدود معدل Grok API: شرح الفئات وحدود RPS وأخطاء 429

كيف تعمل حدود معدل Grok API

تضع SpaceXSI (سابقًا xAI) حدودًا لحركة API لكل نموذج، باستخدام رقمين:

• RPS (الطلبات في الثانية): عدد الاستدعاءات التي يمكنك إرسالها كل ثانية. وتشتقه SpaceXSI من رقم لكل دقيقة: RPS يساوي RPM مقسومًا على 48، بحد أدنى 2.
• TPM (الرموز في الدقيقة): عدد الرموز التي يمكنك تمريرها كل دقيقة. والرموز المخزّنة مؤقتًا تُحتسب ضمن TPM.

تُطبَّق الحدود على كل نموذج على حدة. فحمل عمل كثيف على grok-4.7 لا يستهلك حصتك من grok-4.3. وعندما تتجاوز حدًا ما، تُرجع API الخطأ HTTP 429 ولا يُعالَج الطلب.

ولأن الرموز المخزّنة مؤقتًا تُحتسب ضمن TPM، فإن التخزين المؤقت يخفّض فاتورتك لكنه لا يزيد ميزانية الرموز في الدقيقة. وقد تبلغ الموجّهات الطويلة حد TPM قبل وقت طويل من بلوغ حد الطلبات.

فئات الإنفاق من $0 إلى $5,000

تعتمد فئتك على إجمالي ما أنفقته على API منذ 1 يناير 2026.

أربع قواعد من الوثائق:

• ترتفع الفئات تلقائيًا بمجرد تجاوز عتبة ما.
• لا تنخفض الفئات أبدًا، حتى لو تباطأ إنفاقك.
• لا يُحتسب إلا شراء الرصيد المدفوع مسبقًا والفواتير المدفوعة.
• تمر الحدود الأعلى لنماذج الصور والفيديو في Grok Imagine عبر فريق مبيعات SpaceXSI.

أمثلة على الحدود حسب النموذج

تنشر الوثائق جدولًا لكل نموذج. والأرقام أدناه هي ما قرأناه في 18 أكتوبر 2026. كان الجدول متداخلًا في الصفحة، لذا تعامل مع هذه الأرقام على أنها تقريبية وتحقق من console لمعرفة الحدود المطبّقة على حسابك.

تقع الفئات من 1 إلى 3 بين هذه القيم. ويعرض console الحدود الدقيقة المطبّقة على فريقك.

لواجهة الصوت API حدودها الخاصة. تدرج وثائق Grok Voice 10 جلسات متزامنة لكل فريق ومدة قصوى للجلسة تبلغ 120 دقيقة. راجع دليل Grok Voice API لدينا.

ما العمل عندما تواجه الخطأ 429

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

تنطبق هنا الممارسات المعيارية لأي API ذات حدود معدل:

1. أعد المحاولة بعد انتظار قصير، وزِد مدة الانتظار بعد كل محاولة فاشلة (التراجع الأسي).
2. أضف تأخيرًا عشوائيًا صغيرًا حتى لا يعيد العمال المتوازون المحاولة في اللحظة نفسها.
3. وزّع المهام المتدفقة على فترة زمنية باستخدام طابور بدلًا من إطلاقها كلها دفعة واحدة.
4. سجّل النموذج والحد الذي بلغته. فمشكلات RPS وTPM تحتاج إلى حلول مختلفة.

إذا بلغت حد TPM، فالموجّهات الأقصر تفيد أكثر من الطلبات الأقل. وإذا بلغت حد RPS، فادمج الاستدعاءات الصغيرة حيثما أمكن.

طرق للاستفادة أكثر من حدودك

• استخدم Batch API للأعمال التي يمكنها الانتظار. لا تُحتسب استدعاءات الدفعات ضمن حدود المعدل، وهي أرخص بنسبة 20% على grok-4.3 ونماذج grok-4.20.
• اضبط مفتاح تخزين مؤقت. توصي SpaceXSI بشدة بـ prompt_cache_key أو الترويسة x-grok-conv-id. لن يرفع ذلك TPM لديك، لكنه يخفّض سعر الإدخال المتكرر.
• طابق جهد الاستدلال مع المهمة. يستخدم Grok 4.7 جهدًا عاليًا افتراضيًا. ووجدت Artificial Analysis أن Grok 4.7 أنتج نحو 81k رمز إخراج لكل مهمة في اختباراتها، أي أكثر من ضعف Grok 4.6، لذا فالاستدلال المكثف يستهلك ميزانيات الرموز بسرعة.
• اختر النموذج ذا الحدود المناسبة. في الجدول المنشور، تبدأ عائلة grok-4.5 إلى 4.7 بقيم RPS أعلى من grok-4.3.
• اشترِ الرصيد مسبقًا. بما أن الشراء المسبق والفواتير المدفوعة وحدها تُحتسب في الفئات، فإن إعادة شحن أكبر تنقلك إلى فئة أعلى أسرع.

Enterprise والحدود الأعلى

فوق الفئة 4، تقدّم SpaceXSI فئة Enterprise عند الطلب. وتُرتَّب الفوترة بالفواتير أيضًا عبر فريق المبيعات؛ وهي متوقفة افتراضيًا. ويجب على الفرق التي تحتاج إلى إنتاجية أكبر من Grok Imagine التواصل مع المبيعات أيضًا.

وبالنسبة لبيانات الأعمال، تقول SpaceXSI إنها لا تتدرّب على مدخلات الأعمال أو مخرجاتها وتحذفها خلال 30 يومًا ما لم يتعيّن عليها الاحتفاظ بها. وأسعار كل نموذج موجودة في صفحة أسعار Grok API لدينا، وخطوات الإعداد في نظرة عامة على Grok API.

أسئلة يطرحها الناس