بلوغ حد معدل Groq (429)
Groq سريعة، لذلك يبلغ مفتاح Groq المجاني حدوده سريعًا. عندما يحدث ذلك، ترجع Groq الخطأ HTTP 429 مع رسالة تسمي الحد. تشرح هذه الصفحة الرسالة، والحدود المجانية لكل نموذج، والترويسات التي يجب قراءتها، وكيف تواصل العمل.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
اقرأ رسالة الخطأ
تسمي رسالة 429 من Groq النموذج والمؤسسة ومستوى الخدمة ونوع الحد ومدة الانتظار. نُشر هذا المثال في تقرير خطأ عام:
نص مثال لجسم الخطأ 429
Rate limit reached for model openai/gpt-oss-120b in organization org_<id>
service tier on_demand on tokens per day (TPD): Limit 200000, Used 193487,
Requested 7464. Please try again in 6m50.832s.| الحد في الرسالة | ما الذي نفد | ما يجب فعله |
|---|---|---|
| الطلبات في الدقيقة (RPM) | طلبات كثيرة جدًا خلال 60 ثانية | انتظر بضع ثوان ثم أعد المحاولة |
| الرموز في الدقيقة (TPM) | رموز كثيرة جدًا خلال 60 ثانية | انتظر، أو أرسل مطالبات أقصر |
| الطلبات في اليوم (RPD) | حصة الطلبات اليومية | انتظر المدة المذكورة في الرسالة، أو استخدم نموذجًا آخر |
| الرموز في اليوم (TPD) | حصة الرموز اليومية | انتظر المدة المذكورة في الرسالة، أو استخدم نموذجًا آخر |
الخطأ المختلف هو HTTP 413 مع الرسالة "Request too large". يعني أن طلبًا واحدًا أكبر من حد TPM للنموذج. الانتظار لا يفيد. اجعل الطلب أصغر، أو استخدم نموذجًا بحد TPM أعلى.
حدود الخطة المجانية لـ Groq
تطبق Groq حدود المعدل على المؤسسة، لا على كل مستخدم أو مفتاح. هذه القيم من تبويب Free Plan في صفحة حدود المعدل لدى Groq. لا تُحسب الرموز المخزنة مؤقتًا ضمن الحدود.
| النموذج | RPM | RPD | TPM | TPD |
|---|---|---|---|---|
openai/gpt-oss-120b | 30 | 1,000 | 8,000 | 200,000 |
openai/gpt-oss-20b | 30 | 1,000 | 8,000 | 200,000 |
openai/gpt-oss-safeguard-20b | 3 | 1,000 | 2,000 | 200,000 |
qwen/qwen3.8-27b | 30 | 1,000 | 8,000 | 200,000 |
meta-llama/llama-prompt-guard-2-86m | 30 | 14,400 | 15,000 | 500,000 |
whisper-large-v3 | 20 | 2,000 | - | - |
لنماذج Whisper أيضًا حدود للصوت: 7,200 ثانية صوت في الساعة و28,800 ثانية في اليوم. يعرض الجدول أدناه صفوف Groq في كتالوج FreeLLMAPI. إذا اختلفت قيمة في الكتالوج عن صفحة Groq، فصفحة Groq هي المرجع.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| Qwen3.8 27B | Groq | 262K | 30 طلب/دقيقة 250 طلب/يوم 70,000 رمز/دقيقة ~6M | نعم | نعم |
| GPT-OSS 120B | Groq | 131K | 30 طلب/دقيقة 1,000 طلب/يوم 8,000 رمز/دقيقة 200,000 رمز/يوم ~6M | نعم | لا |
| GPT-OSS 20B | Groq | 131K | 30 طلب/دقيقة 1,000 طلب/يوم 8,000 رمز/دقيقة 200,000 رمز/يوم ~6M | نعم | لا |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 طلب/دقيقة 1,000 طلب/يوم 8,000 رمز/دقيقة 200,000 رمز/يوم ~6M | نعم | لا |
| ALLaM 2 7B | Groq | 4K | 30 طلب/دقيقة 1,000 طلب/يوم 6,000 رمز/دقيقة 500,000 رمز/يوم ~15M | لا | لا |
| Llama Prompt Guard 2 22M | Groq | 512 | 30 طلب/دقيقة 14,400 طلب/يوم 15,000 رمز/دقيقة 14.4K rpd | لا | لا |
| Llama Prompt Guard 2 86M | Groq | 512 | 30 طلب/دقيقة 14,400 طلب/يوم 15,000 رمز/دقيقة 14.4K rpd | لا | لا |
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
ترويسات حد المعدل
تحتوي كل استجابة من Groq على ترويسات حد المعدل. اقرأها لتبطئ قبل أن تحصل على الخطأ 429.
| الترويسة | تشير إلى | المعنى |
|---|---|---|
x-ratelimit-limit-requests | RPD | الطلبات المسموح بها في اليوم |
x-ratelimit-remaining-requests | RPD | الطلبات المتبقية اليوم |
x-ratelimit-reset-requests | RPD | المدة حتى يُعاد ضبط حد الطلبات، مثلًا 2m59.56s |
x-ratelimit-limit-tokens | TPM | الرموز المسموح بها في الدقيقة |
x-ratelimit-remaining-tokens | TPM | الرموز المتبقية في هذه الدقيقة |
x-ratelimit-reset-tokens | TPM | المدة حتى يُعاد ضبط حد الرموز، مثلًا 7.66s |
retry-after | أي حد | عدد الثواني للانتظار. تضبطها Groq فقط بعد بلوغ حد. |
اعرض الترويسات
curl -s -D - -o /dev/null https://api.groq.com/openai/v1/chat/completions \
-H "Authorization: Bearer <groq-key>" \
-H "Content-Type: application/json" \
-d '{"model": "openai/gpt-oss-20b", "messages": [{"role": "user", "content": "hi"}]}' \
| grep -i -E 'x-ratelimit|retry-after'أعد المحاولة بشكل صحيح
استخدم retry-after عندما ترسلها Groq. إذا كانت غائبة، فاستخدم التراجع الأسي مع حد أقصى. لا تعد محاولة الحدود اليومية في حلقة ضيقة. كل إعادة محاولة طلب جديد.
أعد المحاولة باستخدام retry-after (Python)
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.groq.com/openai/v1", api_key="<groq-key>")
def ask(prompt, model="openai/gpt-oss-20b"):
for attempt in range(5):
try:
r = client.chat.completions.create(model=model, messages=[{"role": "user", "content": prompt}])
return r.choices[0].message.content
except RateLimitError as e:
wait = e.response.headers.get("retry-after")
time.sleep(float(wait) if wait else min(60, 2 ** attempt))
raise RuntimeError("Groq rate limit: retries used up")- إذا ذكرت الرسالة RPD أو TPD وكانت مدة الانتظار دقائق، فانتقل إلى نموذج أو مزود آخر.
- للحصول على حدود أعلى من Groq، رقِّ الحساب إلى الطبقة Developer. تحتاج إلى طريقة دفع.
- الخطأ HTTP 498 خطأ مختلف. يعني أن طبقة flex بلغت طاقتها.
خطط لميزانية Groq
الحدود المجانية صغيرة عند إجراء الحسابات. تحقق من الحد الذي يوقفك أولًا في حمل عملك.
- الطلبات: عند 30 طلبًا في الدقيقة، يكفي 1,000 طلب في اليوم لنحو 34 دقيقة من الاستخدام بأقصى سرعة.
- الرموز في الدقيقة: يسمح 8,000 TPM بنحو أربعة طلبات بكل منها 2,000 رمز في الدقيقة. طلب واحد بـ 9,000 رمز يعطي الخطأ 413.
- الرموز في اليوم: يساوي 200,000 TPD نحو 25 طلبًا بكل منها 8,000 رمز. ترسل وكلاء البرمجة مطالبات كبيرة، لذلك غالبًا ما تنفد TPD قبل RPD.
- المؤسسة: تشترك كل المفاتيح وكل أعضاء المؤسسة في هذه الأرقام.
في عمل الوكلاء، أبقِ المطالبات قصيرة وواضحة، ونظّف السياق القديم كثيرًا. استخدم Groq للاستدعاءات السريعة والقصيرة. وأرسل الاستدعاءات ذات السياق الطويل إلى مزودين لديهم حد رموز أعلى.
حوّل الطلب عند امتلاء Groq
FreeLLMAPI بوابة مفتوحة المصدر تعمل على حاسوبك. تحتفظ بعدادات RPM وRPD وTPM وTPD لكل نموذج ومفتاح في Groq. تفحصها قبل كل طلب. عندما تمتلئ Groq، يرسل الموجّه الطلب إلى المزود المجاني التالي.
- يضع الخطأ 429 القصير على حد الدقيقة المفتاح في فترة تبريد مدتها 90 ثانية.
- يستخدم الخطأ 429 على حد يومي فترة تبريد أطول، أو وقت إعادة المحاولة من Groq إذا كان أطول.
- عندما يذكر نص خطأ Groq الحد الحقيقي، يحفظه الموجّه. مثلًا، يضبط الخطأ 413 مع
Limit 30000, Requested 33476حد TPM على 30,000. - تعرض ترويسة
X-Fallback-Trailكل خطوة فاشلة، مثلًاgroq/llama-3.3-70b key1=rate_limited.
استدعِ البوابة بدلًا من Groq
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto:fast", "messages": [{"role": "user", "content": "hi"}]}'يفضل auto:fast النماذج ذات أفضل سرعة مقاسة. عندما تبلغ Groq حدها، تجيب مزودون آخرون. قد يكونون أبطأ من Groq.
الأسئلة الشائعة
ماذا يعني 'Rate limit reached for model' في Groq؟
استنفدت مؤسستك كل حد واحد لهذا النموذج. تسمي الرسالة الحد (RPM أو RPD أو TPM أو TPD) والوقت الذي يجب انتظاره.
ما حدود المعدل للطبقة المجانية في Groq؟
تختلف الحدود حسب النموذج. في الخطة المجانية، يسمح openai/gpt-oss-120b بـ 30 طلبًا في الدقيقة، و1,000 في اليوم، و8,000 رمز في الدقيقة، و200,000 رمز في اليوم.
لماذا أحصل على الخطأ 413 Request too large من Groq؟
يحتوي طلب واحد على رموز أكثر من حد TPM للنموذج. اجعل المطالبة أقصر، أو استخدم نموذجًا بحد TPM أعلى. الانتظار لا يصلح ذلك.
هل يعيد مفتاح Groq API جديد ضبط حد المعدل؟
لا. تطبق Groq الحدود على المؤسسة، لذلك تتشارك كل المفاتيح فيها الحدود نفسها.
كيف أرفع حد معدل Groq الخاص بي؟
رقِّ الحساب إلى الطبقة Developer مع طريقة دفع. للبقاء مجانيًا، أضف مزودين آخرين خلف بوابة تحوّل الطلب عند امتلاء Groq.
أدلة ذات صلة
- حدود معدل واجهات LLM المجانية
- free groq api
- تجاوز حصة Gemini API (429 RESOURCE_EXHAUSTED)
- حد معدل NVIDIA NIM API
- Groq مقابل Cerebras
المصادر
- GroqCloud: Rate limits (تم التحقق 20 November 2026)
- GroqCloud: Errors (تم التحقق 20 November 2026)
- GroqCloud: Billing FAQs (تم التحقق 20 November 2026)
- Public report of the Groq TPD message (Discourse) (تم التحقق 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (تم التحقق 20 November 2026)
- FreeLLMAPI docs: Response headers (تم التحقق 20 November 2026)