الرئيسية / الأدلة / بلوغ حد معدل Groq (429)

بلوغ حد معدل 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. لا تُحسب الرموز المخزنة مؤقتًا ضمن الحدود.

حدود Groq Free Plan، تم التحقق منها في 20 نوفمبر 2026
النموذجRPMRPDTPMTPD
openai/gpt-oss-120b301,0008,000200,000
openai/gpt-oss-20b301,0008,000200,000
openai/gpt-oss-safeguard-20b31,0002,000200,000
qwen/qwen3.8-27b301,0008,000200,000
meta-llama/llama-prompt-guard-2-86m3014,40015,000500,000
whisper-large-v3202,000--

لنماذج Whisper أيضًا حدود للصوت: 7,200 ثانية صوت في الساعة و28,800 ثانية في اليوم. يعرض الجدول أدناه صفوف Groq في كتالوج FreeLLMAPI. إذا اختلفت قيمة في الكتالوج عن صفحة Groq، فصفحة Groq هي المرجع.

نماذج Groq في الكتالوج المجاني اليوم
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
Qwen3.8 27BGroq262K30 طلب/دقيقة
250 طلب/يوم
70,000 رمز/دقيقة
~6M
نعمنعم
GPT-OSS 120BGroq131K30 طلب/دقيقة
1,000 طلب/يوم
8,000 رمز/دقيقة
200,000 رمز/يوم
~6M
نعملا
GPT-OSS 20BGroq131K30 طلب/دقيقة
1,000 طلب/يوم
8,000 رمز/دقيقة
200,000 رمز/يوم
~6M
نعملا
GPT-OSS Safeguard 20BGroq131K30 طلب/دقيقة
1,000 طلب/يوم
8,000 رمز/دقيقة
200,000 رمز/يوم
~6M
نعملا
ALLaM 2 7BGroq4K30 طلب/دقيقة
1,000 طلب/يوم
6,000 رمز/دقيقة
500,000 رمز/يوم
~15M
لالا
Llama Prompt Guard 2 22MGroq51230 طلب/دقيقة
14,400 طلب/يوم
15,000 رمز/دقيقة
14.4K rpd
لالا
Llama Prompt Guard 2 86MGroq51230 طلب/دقيقة
14,400 طلب/يوم
15,000 رمز/دقيقة
14.4K rpd
لالا

بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.

ترويسات حد المعدل

تحتوي كل استجابة من Groq على ترويسات حد المعدل. اقرأها لتبطئ قبل أن تحصل على الخطأ 429.

الترويسةتشير إلىالمعنى
x-ratelimit-limit-requestsRPDالطلبات المسموح بها في اليوم
x-ratelimit-remaining-requestsRPDالطلبات المتبقية اليوم
x-ratelimit-reset-requestsRPDالمدة حتى يُعاد ضبط حد الطلبات، مثلًا 2m59.56s
x-ratelimit-limit-tokensTPMالرموز المسموح بها في الدقيقة
x-ratelimit-remaining-tokensTPMالرموز المتبقية في هذه الدقيقة
x-ratelimit-reset-tokensTPMالمدة حتى يُعاد ضبط حد الرموز، مثلًا 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.

استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

الأسئلة الشائعة

ماذا يعني '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.

أدلة ذات صلة

المصادر

كل الأدلة · تصفح كل النماذج المجانية