Groq error map: structural errors need a fix, transient ones need backoff

TL;DR

Structural, fix the request: 401 invalid or missing key, 400 deprecated model or bad parameters, 413 request over the context window (Llama models cap at 128K tokens, trim the prompt). Transient, retry with backoff and honor retry-after: 429 RPM/TPM/RPD limits, 500/503 Groq-side outage or overload with a model fallback.

The error

structural errors need a fix, transient ones need backoff

Fix

1. Structural, fix the request: 401 invalid or missing key, 400 deprecated model or bad parameters, 413 request over the context window (Llama models cap at 128K tokens, trim the prompt). Expected: You get the expected result; the problem is gone.

2. Re-run the original operation and confirm the error is gone. Expected: no error, normal output.

When to use

• You hit this exact error with Groq error map.
• The symptom matches: structural errors need a fix, transient ones need backoff.

When NOT to use

• A different error message from Groq error map; the cause here is specific to this error.
• Unrelated Groq error map issues (different feature, different failure).
• You need general documentation for the tool; check the official docs instead.

Compatibility

Reported against Groq error map.

Variant phrasings

structural errors need a fix, transient ones need backoff

Why it happens

Retry the wrong Groq error and you burn quota for nothing.

Edge cases

• If your error message differs even slightly, this is probably a different issue; search the exact text.
• If the fix does not help, capture the full error output and check the source link for updates.

Source: Retry the wrong Groq error and you burn quota for nothing.

Verified resolution: [groq-common-errors skill]: structural, fix the request: 401 invalid or missing key, 400 deprecated model or bad parameters, 413 request over the context window (Llama models cap at 128K tokens, trim the prompt). Transient, retry with backoff and honor retry-after: 429 RPM/TPM/RPD limits, 500/503 Groq-side outage or overload with a model fallback. The 413-on-TPM variant means one request exceeded the per-minute token budget: shrink the request, not the retry interval.

Source URL: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/HEAD/./skills/.curated/groq-common-errors/SKILL.md