Este é o erro 429 que o backoff não consegue corrigir. insufficient_quota significa que sua conta não tem crédito disponível para gastos — a solicitação foi rejeitada antes de qualquer modelo ser executado e continuará sendo rejeitada até que a cobrança seja alterada. Veja como confirmar em qual estado de cobrança você está e resolvê-lo em minutos.
O erro
{
"error": {
"message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
"type": "insufficient_quota",
"param": null,
"code": "insufficient_quota"
}
}Causas e soluções em resumo
| Causa | Solução |
|---|---|
| Saldo de créditos pré-pagos é $0 | A API é pré-paga: compre créditos (ou ative a recarga automática) em Settings → Billing. Um cartão salvo, por si só, não adiciona nada até que os créditos sejam comprados. |
| Créditos do período de teste gratuito expiraram ou foram consumidos | Os créditos de teste expiram (normalmente após 3 meses), mesmo que não sejam usados. A solução é a mesma: adicione uma forma de pagamento e compre créditos. |
| Limite de orçamento mensal atingido | Um orçamento definido por você em Limits bloqueia as solicitações pelo restante do mês quando é atingido. Aumente-o ou espere o início do próximo mês. |
| A chave pertence a um projeto ou organização sem orçamento | As chaves sk-proj- gastam do próprio projeto; um projeto pode ter um limite próprio (menor) que o da organização. Verifique o projeto da chave no painel, não apenas o total da organização. |
Confirme que é cota, não limitação de taxa
Leia error.type. rate_limit_exceeded é resolvido sozinho em até um minuto e merece backoff; insufficient_quota nunca é resolvido sozinho, e repeti-lo é apenas ruído. Se não tiver certeza, uma tentativa após 60 segundos esclarece: continuar retornando 429 com a mesma mensagem significa que é cobrança.
Verifique o saldo de créditos do qual a chave realmente gasta
Em platform.openai.com → Settings → Billing, verifique o saldo de créditos. Zero ou negativo: compre créditos. Depois verifique Settings → Limits para ver o limite de orçamento mensal e, no caso de chaves sk-proj-, os próprios limites de uso do projeto proprietário. Os três podem produzir esse erro de forma independente.
Interrompa a recorrência, não apenas o incidente
Ative a recarga automática com um limite sensato para que um fim de semana movimentado não derrube a produção, e configure o alerta de orçamento (não apenas o limite rígido) para saber que os limites estão se aproximando antes que as solicitações comecem a falhar.
Se você estiver chamando pela Kunavo
A Kunavo usa o mesmo modelo pré-pago, portanto a comparação honesta diz respeito ao alcance do impacto na carteira, não ao mecanismo: um único saldo da Kunavo cobre GPT e Claude juntos, com preço por token, e solicitações com falha nunca são cobradas. Quando a própria carteira da Kunavo fica sem saldo, você recebe um 402 com o código insufficient_quota (deliberadamente o mesmo código, para que o tratamento de erros dos SDKs da OpenAI seja mantido) — adicionar saldo resolve imediatamente, sem limites mensais que precisem ser desbloqueados. Está orçando a solução? As tarifas atuais por token do GPT, com a lista oficial da OpenAI ao lado das nossas, estão na lista de preços da API do GPT.
Perguntas frequentes
Adicionei um cartão de crédito — por que ainda recebo insufficient_quota?
Porque a API usa créditos pré-pagos, não o cartão diretamente. Adicionar um cartão apenas permite comprar; você ainda precisa comprar créditos ou ativar a recarga automática. O erro desaparece em um ou dois minutos depois que o saldo fica positivo.
insufficient_quota alguma vez se resolve sozinho?
Somente em um caso: um limite de orçamento mensal, que é redefinido quando começa um novo mês. Os casos de saldo zero e período de teste expirado persistem até que você compre créditos. De qualquer forma, loops de novas tentativas não ajudam — a solicitação é rejeitada antes que qualquer modelo seja executado.
As solicitações 429 com falha custam alguma coisa?
Não — a OpenAI as rejeita antes da inferência, e na Kunavo as solicitações com falha também nunca são cobradas. O custo é a indisponibilidade, por isso a recarga automática combinada com um alerta de orçamento é melhor que apenas um limite rígido.
Guias relacionados
- Limites de taxa da OpenAI API — qual limite você atingiu, como interpretá-lo e a nova tentativa que resolve
- Preços da API GPT da OpenAI em 2026 — custos do GPT-6, GPT-5.6 e GPT-5.5, exemplos e acesso mais barato
Mais detalhes sobre o significado dos erros estão em referência de erros; obter uma chave leva um minuto por meio de cadastro e da guia de autenticação.