groq-common-errors

# Groq Common Errors ## Overview Comprehensive reference for Groq API error codes, their root causes, and proven fixes. Groq returns standard HTTP status codes with structured error bodies and rate-limit headers. ## Error Response Format ```json { "error": { "message": "Rate limit reached for model `llama-3.3-70b-versatile`...", "type": "tokens", "code": "rate_limit_exceeded" } } ``` ## Quick Diagnostic ```bash set -euo pipefail # 1. Verify API key is valid curl -s https://api.groq.com/openai/v1/models \ -H "Authorization: Bearer $GROQ_API_KEY" | jq '.data | length' # 2. Check specific model availability curl -s https://api.groq.com/openai/v1/models \ -H "Authorization: Bearer $GROQ_API_KEY" | jq '.data[].id' | sort # 3. Test a minimal completion curl -s https://api.groq.com/openai/v1/chat/completions \ -H "Authorization: Bearer $GROQ_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"llama-3.1-8b-instant","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' | jq . ``` ## Error Reference ### 401 — Authentication Error ``` Authentication error: Invalid API key provided ``` **Causes**: Key missing, revoked, or malformed. **Fix**: ```bash # Verify key is set and starts with gsk_ echo "${GROQ_API_KEY:0:4}" # Should print "gsk_" # Test key directly curl -s -o /dev/null -w "%{http_code}" \ https://api.groq.com/openai/v1/models \ -H "Authorization: Bearer $GROQ_API_KEY" # Should return 200 ``` ### 429 — Rate Limit Exceede...