Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Groq API error

Groq API 498 capacity_exceeded: what it means and how to fix it

Error message
498 capacity_exceeded

Retry? YesLast verified 1 documented fix2 sources

What it means

Custom Groq status code (Flex Tier Capacity Exceeded) returned when the flex service tier is at capacity and the request will not be processed. Flex requests fail quickly with status 498 and error capacity_exceeded.

Causes

  • Flex tier capacity is unavailable for a request sent with service_tier set to flex

How to fix it

  1. Fix 1.

    Try again later. Add jittered backoff and retries to smooth spikes.

More Groq API errors

All 14 Groq API errors

FAQ

What does the Groq API error "498 capacity_exceeded" mean?

Custom Groq status code (Flex Tier Capacity Exceeded) returned when the flex service tier is at capacity and the request will not be processed. Flex requests fail quickly with status 498 and error capacity_exceeded.

How do I fix Groq API "498 capacity_exceeded"?

Try again later. Add jittered backoff and retries to smooth spikes.

Should I retry Groq API "498 capacity_exceeded"?

Yes. The official docs treat this error as retryable.

Sources

Last verified against 2 sources: Groq API's official docs and official SDK repositories.

Newsletter

Know when the APIs change

One email per week. New model releases, API changes, what broke, and how developers are working around it.