OpenRouter Rate Limits: Corrigir erros 429 e limites gratuitos

OpenRouter rate limits explained: 20 requests per minute, 50 per day on free models, what a 429 means and how to fix it. Credits at AI Perks. Hmm, that's a mismatch: the source is already in English and I've copied it verbatim. Here is the Portuguese translation: OpenRouter rate limits explained: 20 requests per minute, 50 per day on free models, what a 429 means and how to fix it. Credits at AI Perks.

OpenRouter Rate LimitsOpenRouter 429OpenRouter Free Models LimitOpenRouter Daily LimitFree AI CreditsAI Perks
Andrew
Andrew
AI Perks Team
11,321•

Quick Answer

Modelos gratuitos no OpenRouter permitem 20 solicitações por minuto e 50 por dia, aumentando para 1,000 por dia depois que você comprar pelo menos $10 em créditos. Um 429 vem do OpenRouter ou do provedor upstream. Créditos de fornecedores listados em getaiperks.com removem o limite do pool gratuito compartilhado.

AI Perks

O AI Perks oferece acesso a descontos exclusivos, créditos e ofertas em ferramentas de IA, serviços em nuvem e APIs para ajudar startups e desenvolvedores a economizar.

AI Perks Cards

Quais são os limites de taxa do OpenRouter nos modelos gratuitos?

Os modelos gratuitos têm limite de 20 requisições por minuto e 50 por dia. Comprar pelo menos $10 em créditos eleva o limite diário para 1,000. Os modelos pagos não têm limite de taxa baseado no plano.

Se você está vendo um 429, a correção permanente mais rápida geralmente são créditos, não código. Até $3,000 em créditos do OpenRouter está listado no catálogo do AI Perks, e o cartão mostra quem se qualifica e como resgatar.

Dois detalhes pegam as pessoas de surpresa. Tentativas que falham contam para o limite diário de modelos gratuitos, e um saldo negativo bloqueia os modelos gratuitos até que você adicione créditos.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

Como os limites gratuitos e pagos se comparam?

A tabela de planos é simples: o plano Free permite 50 requisições por dia, os planos pagos repassam os limites do provedor, e o Enterprise pode obter cotas mais altas.

ConfiguraçãoLimite de taxa
Modelos gratuitos, sem créditos comprados20 requisições/min, 50 requisições/dia
Modelos gratuitos, com pelo menos $10 comprados20 requisições/min, 1,000 requisições/dia
Modelos pagosSem limite baseado no plano, limites do provedor são repassados
EnterpriseCotas mais altas disponíveis

O nível de limite gratuito é definido pelo total de créditos comprados desde o início, e não pela flag is_free_tier. Para absorver arredondamentos e taxas de recarga, o teto diário mais alto é concedido a partir de um crédito abaixo do limite de $10.

Para ver a lista de modelos, consulte OpenRouter Free Models: Lista e Limites.


O que um 429 do OpenRouter realmente significa?

Um 429 pode ter três origens, e a correção depende de qual delas você atingiu.

1. O próprio OpenRouter. Você atingiu um limite da plataforma: requisições de modelos gratuitos por minuto ou por dia, ou a proteção contra DDoS. Essa proteção bloqueia requisições que excedem muito o uso razoável.

2. O provedor upstream. O provedor que atende sua requisição está limitando a taxa ou está com capacidade esgotada. Quando disponível, error.metadata.provider_code traz o código de erro original do provedor. O roteamento de fallback tenta outros provedores para o mesmo modelo antes que esse erro chegue até você.

3. Sua própria conta no provedor (BYOK). Se você usa suas próprias chaves de provedor, um 429 significa que a conta no provedor atingiu o limite de taxa. Verifique as configurações do provedor ou aguarde.

Quando todos os provedores tentados retornam uma sugestão de nova tentativa, a resposta também traz um cabeçalho Retry-After.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

Como verificar sua chave e o uso diário?

Faça uma requisição GET para o endpoint de chave em https://openrouter.ai/api/v1/key. Ele mostra o limite de taxa e os créditos restantes nessa chave, além das requisições de modelos gratuitos registradas até agora no dia UTC atual.

O limite por minuto não é informado ali. Respostas bem-sucedidas também não trazem cabeçalhos X-RateLimit-*, o que torna o endpoint de chave a única forma de monitorar sua cota.


Como corrigir um 429 no OpenRouter?

Associe a correção à causa:

  • Tente novamente com backoff exponencial. Os limites de taxa são temporários, então espere em vez de reenviar imediatamente, e respeite Retry-After quando presente.
  • Nas variantes gratuitas, compre pelo menos $10 em créditos para elevar o limite diário, ou mude para a variante paga, que não tem limite de requisições no nível da plataforma.
  • Distribua a carga entre modelos. Contas extras ou chaves de API não aumentam os limites, mas modelos diferentes têm limites diferentes.
  • Não crie contas extras. Os Termos de Serviço proíbem múltiplas contas para contornar limites de uso.
  • Use BYOK para que os limites sejam gerenciados pela sua conta no provedor. Por padrão, o OpenRouter recorre a endpoints compartilhados se todas as suas chaves atingirem um limite ou falharem.

Tenha cuidado com listas de fallback: adicionar um modelo pago depois de um modelo :free cobra o modelo pago pelo seu preço.

Quanto custa realmente desbloquear os $10?

A compra mínima é de $5 por transação. Compras que não são em cripto custam 5.5% com taxa mínima de $0.80, e 5.5% de $10 é menos que $0.80, então o mínimo se aplica a uma recarga de $10. Créditos não utilizados só podem ser reembolsados em até 24 horas após a transação.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

Quais créditos gratuitos removem o teto do pool gratuito compartilhado?

Créditos de fornecedores tiram você do pool gratuito compartilhado. Os modelos pagos não têm limite baseado no plano, e créditos diretos de provedores o colocam sob os limites do seu próprio provedor. Cada cartão mostra quem se qualifica e como resgatar.

EmpresaCréditos gratuitosComo obter
OpenRouterAté $3,000Obter este benefício
Anthropic API$20,000Obter este benefício
Claude via parceirosAté $100,000Obter este benefício
Google Cloud (Vertex AI, Gemini)$350,000Obter este benefício
AWS (Amazon Bedrock)$300,000Obter este benefício
Azure OpenAI$150,000Obter este benefício
Together AIAté $50,000Obter este benefício
CerebrasAté $22,500Obter este benefício
Mistral AI$10,000Obter este benefício
OpenAI API$1,200Obter este benefício

Total dos dez benefícios: $3,000 + $20,000 + $100,000 + $350,000 + $300,000 + $150,000 + $50,000 + $22,500 + $10,000 + $1,200 = até $1,006,700 em créditos gratuitos.

Vale saber sobre BYOK aqui. Os planos Standard e Business incluem $25,000 por mês de inferência ao preço de tabela via BYOK, sem taxa do OpenRouter; acima disso, o OpenRouter cobra 5% deduzidos dos seus créditos. Mais sobre roteamento em Créditos gratuitos do OpenRouter: até $3,000 mais BYOK.


Como sair do limite do pool gratuito, passo a passo?

  1. Obtenha créditos pelo AI Perks. Abra o catálogo em getaiperks.com, escolha um cartão na tabela acima e siga os passos de resgate mostrados ali.
  2. Verifique sua chave. Chame o endpoint de chave e anote seus créditos e as requisições de modelos gratuitos usadas no dia UTC atual.
  3. Desative :free no tráfego de produção. Aponte a requisição para a variante paga do mesmo modelo, que não tem limite de requisições no nível da plataforma.
  4. Adicione backoff. Tente novamente com backoff exponencial, respeite Retry-After e limite as tentativas para que um loop com falha não esgote uma cota gratuita.
  5. Mova o tráfego pesado para BYOK se você tiver créditos com um provedor direto, para que a sua conta no provedor defina os limites.

Para um olhar mais detalhado sobre o que o nível gratuito permite, leia OpenRouter Free Tier: Real Limits, Fusion, and the Stripe Deal.


Principais Créditos de IA para Startups

Candidate-se diretamente por meio destes programas verificados.

FAQ

Quantas requisições posso fazer por dia aos modelos gratuitos do OpenRouter?

Sem nenhuma compra de créditos, você tem 50 requisições de modelos gratuitos por dia, além de um limite de 20 por minuto. Depois de comprar pelo menos $10 em créditos, o limite diário passa para 1,000. Tentativas que falham também contam. Confira o cartão do OpenRouter para créditos que cobrem modelos pagos.

Requisições que falham contam para o limite diário do OpenRouter?

Sim. Tentativas que falham contam para o limite diário de modelos gratuitos, então um loop de repetição mal configurado pode consumir sua cota antes de retornar qualquer coisa útil. Tentativas com erro não são cobradas pelos tokens do modelo, mas ainda consomem a cota do nível gratuito. Limite suas tentativas e use backoff.

Uma segunda conta ou chave de API vai aumentar meu limite?

Não. Contas extras ou chaves de API não aumentam os limites de taxa, e os Termos de Serviço proíbem criar múltiplas contas para contornar limites de uso. Modelos diferentes têm limites diferentes, então distribuir as requisições entre modelos ajuda. Para ter margem real, veja os créditos em getaiperks.com.

Por que recebo um 429 em um modelo pago?

Os modelos pagos não têm limite do OpenRouter baseado no plano, então o 429 geralmente vem do provedor upstream, que está limitando a taxa ou com capacidade esgotada. Verifique error.metadata.provider_code e qualquer cabeçalho Retry-After. Com BYOK, significa que a sua própria conta no provedor atingiu o limite.

Posso ver meu uso por minuto?

Não. O endpoint de chave informa os créditos restantes e as requisições de modelos gratuitos usadas no dia UTC atual, mas não a contagem por minuto. Respostas bem-sucedidas também não trazem cabeçalhos X-RateLimit-*. Acompanhe as chamadas por minuto no seu próprio cliente e compare as opções de créditos de fornecedores em getaiperks.com.


Pronto para parar de bater no limite gratuito?

Um 429 em um modelo gratuito é um limite de pool, não um bug no seu código. Os créditos o levam para modelos pagos e para os limites do seu próprio provedor, e os cartões mostram exatamente quem se qualifica e como resgatar.

Obtenha créditos gratuitos de IA em getaiperks.com →

Veja o catálogo completo em getaiperks.com e comece seu próximo teste sem o teto do pool compartilhado.

AI Perks

O AI Perks oferece acesso a descontos exclusivos, créditos e ofertas em ferramentas de IA, serviços em nuvem e APIs para ajudar startups e desenvolvedores a economizar.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.