Groq のレート制限に達した (429)
Groq は高速なため、無料の Groq キーはすぐに上限に達します。上限に達すると、Groq は HTTP 429 を返します。そのメッセージには、上限の種類が示されます。このページでは、そのメッセージ、モデルごとの無料の上限、読むべきヘッダー、作業を続ける方法を説明します。
コード、モデル名、ライブのカタログラベルは英語で表示します。
エラーメッセージを読む
Groq の 429 メッセージには、モデル、組織、サービスティア、上限の種類、待機時間が示されます。この例は、公開されたバグ報告に投稿されたものです。
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.| メッセージ内の上限 | 上限を超えた内容 | 対処 |
|---|---|---|
| 1 分あたりのリクエスト数 (RPM) | 60 秒間のリクエストが多すぎる | 数秒待ってから再試行します |
| 1 分あたりのトークン数 (TPM) | 60 秒間のトークンが多すぎる | 待つか、短いプロンプトを送ります |
| 1 日あたりのリクエスト数 (RPD) | 1 日のリクエストの枠 | メッセージに示された時間を待つか、別のモデルを使います |
| 1 日あたりのトークン数 (TPD) | 1 日のトークンの枠 | メッセージに示された時間を待つか、別のモデルを使います |
別のエラーとして、HTTP 413 と「Request too large」があります。これは、1 件のリクエストがモデルの TPM 上限を超えていることを意味します。待っても解決しません。リクエストを小さくするか、TPM 上限の高いモデルを使ってください。
Groq の無料プランの上限
Groq のレート制限は、ユーザーやキーごとではなく、組織に適用されます。以下の値は、Groq のレート制限のページにある Free Plan のタブからのものです。キャッシュされたトークンは、上限には含まれません。
| モデル | 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 モデルには、音声の上限もあります。1 時間あたり 7,200 音声秒、1 日あたり 28,800 音声秒です。以下の表には、FreeLLMAPI のカタログにある Groq の行を示しています。カタログの値と 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 | 1 日に許可されるリクエスト数 |
x-ratelimit-remaining-requests | RPD | 本日残っているリクエスト数 |
x-ratelimit-reset-requests | RPD | リクエストの上限がリセットされるまでの時間。例: 2m59.56s |
x-ratelimit-limit-tokens | TPM | 1 分あたりに許可されるトークン数 |
x-ratelimit-remaining-tokens | TPM | この 1 分間に残っているトークン数 |
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'正しく再試行する
Groq が送る場合は、retry-after を使います。ない場合は、上限付きの指数バックオフを使います。1 日の上限を、短い間隔のループで再試行しないでください。再試行のたびに、新しいリクエストになります。
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 の予算を計画する
計算すると、無料の上限は小さいです。作業内容に応じて、どの上限が最初に止めるかを確認してください。
- リクエスト: 1 分あたり 30 リクエストの場合、1 日 1,000 リクエストは、全速で約 34 分の利用に相当します。
- 1 分あたりのトークン数: 8,000 TPM の場合、1 分間に 2,000 トークンのリクエストを約 4 件送れます。9,000 トークンの 1 件のリクエストは、エラー 413 になります。
- 1 日あたりのトークン数: 200,000 TPD は、8,000 トークンのリクエストを約 25 件に相当します。コーディングエージェントは大きいプロンプトを送るため、RPD より先に TPD を使い切ることがよくあります。
- 組織: 組織のすべてのキーとすべてのメンバーが、これらの数値を共有します。
エージェントの作業では、プロンプトを短く明確に保ち、古い文脈を頻繁に削除してください。速く短い呼び出しには Groq を使います。長い文脈の呼び出しは、トークンの上限が高いプロバイダに送ってください。
Groq が上限に達したらフェイルオーバーする
FreeLLMAPI は、お使いのコンピュータ上で動作するオープンソースのゲートウェイです。Groq の各モデルとキーごとに、RPM、RPD、TPM、TPD のカウンターを保持します。各リクエストの前にこれらを確認します。Groq が上限に達すると、ルーターはリクエストを次の無料プロバイダに送ります。
- 1 分単位の上限による短い 429 では、そのキーを 90 秒のクールダウンに入れます。
- 1 日の上限による 429 では、より長いクールダウンを使います。Groq の再試行時間の方が長い場合は、その時間を使います。
- Groq のエラー本文に実際の上限が示されている場合、ルーターはそれを保存します。例えば、
Limit 30000, Requested 33476を含む 413 の場合、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 より遅い場合があります。
よくある質問
Groq で「Rate limit reached for model」は何を意味しますか?
その モデルについて、組織がある 1 つの上限を使い切ったことを意味します。メッセージには、上限の種類 (RPM、RPD、TPM、TPD) と待機時間が示されます。
Groq の無料枠のレート制限はどれくらいですか?
値はモデルによって異なります。無料プランでは、openai/gpt-oss-120b は 1 分あたり 30 リクエスト、1 日あたり 1,000 リクエスト、1 分あたり 8,000 トークン、1 日あたり 200,000 トークンを許可します。
Groq のエラー 413「Request too large」が出るのはなぜですか?
1 件のリクエストのトークン数が、モデルの TPM 上限を超えています。プロンプトを短くするか、TPM 上限の高いモデルを使ってください。待っても解決しません。
新しい Groq の API キーで、レート制限はリセットされますか?
いいえ。Groq は上限を組織に適用するため、組織のすべてのキーが同じ上限を共有します。
Groq のレート制限を上げるには?
支払い方法を登録して、Developer ティアにアップグレードします。無料のままにするには、Groq が上限に達したときにフェイルオーバーするゲートウェイの背後に、他のプロバイダを追加してください。
関連ガイド
- 無料LLM APIのレート制限
- 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)