Free LLM APIs · errors
Free LLM API errors
Free tiers fail in their own ways: daily allowances, per-minute token caps, providers at capacity, privacy settings that leave nothing to route to. Each page below explains one error from the provider's own documentation, with the fix.
OpenRouter
- HTTP 429Rate limit exceeded: free-models-per-dayYour account has used its daily allowance of requests to :free models. It is one allowance for every free model together, counted per UTC day.
- HTTP 429Rate limit exceeded: free-models-per-minYou sent more than 20 requests in a minute to :free models. Unlike the daily limit, this one clears on its own within the minute.
- HTTP 429Provider returned errorOpenRouter passed your request to the provider that serves the model, and that provider refused it. With free models it is usually capacity: the free endpoint is saturated.
- HTTP 404No endpoints found matching your data policy (Free model training)Every provider that serves this model may store or train on prompts, and your privacy settings (or the request's data_collection) exclude such providers. So nothing is left to route to.
- HTTP 401User not foundOpenRouter does not recognise the account behind your API key: the key was deleted or disabled, or the account or workspace it belonged to no longer exists.
- HTTP 200HTTP 200, but the reply is empty or the stream ends with finish_reason "error"OpenRouter sends 200 as soon as a provider accepts the request. Anything that goes wrong after that is reported inside the response, not in the status code.
Groq
- HTTP 413Request too large for model `<model>` … on tokens per minute (TPM): Limit 8000, Requested <n>A single request is bigger than the model's tokens-per-minute (TPM) limit on your plan. On the free plan that is 8,000 tokens for the popular models, so no amount of waiting lets this request through.
- HTTP 429429 Too Many RequestsYou went over one of the model's limits: requests per minute (RPM), requests per day (RPD), tokens per minute (TPM) or tokens per day (TPD). Each model has its own.
Gemini API
- HTTP 429429 RESOURCE_EXHAUSTEDYou went over a limit of your Google AI Studio project: a per-minute request or token limit, or the daily quota.
- HTTP 400Developer instruction is not enabled for models/gemma-3-27b-itYou sent a system instruction (a system message, in OpenAI terms) to a Gemma model whose Gemini API endpoint does not accept one.