groq-common-errors

Featured

Diagnose and fix Groq API errors with real error codes and solutions. Use when encountering Groq errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "groq error", "fix groq", "groq not working", "debug groq", "groq 429".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category