Chave ausente, inválida ou revogada. Confira o header Authorization.
Status HTTP previsíveis, corpo sempre com detail.
Trate 429 com backoff, 402 avisando o usuário sobre créditos, e o resto como erro genérico — não tente adivinhar semântica além do status.
4014024034295xx
Créditos insuficientes para a chamada. Recarregue em /faturamento.
Limite de requests por minuto excedido. Respeite o header Retry-After.
Tabela de status
O que cada código realmente significa nesta API.
Sem Authorization, chave malformada, ou revogada.
Créditos insuficientes — o corpo detalha o motivo (ex: site_generation).
Conta desativada.
Rate limit por minuto excedido; veja X-RateLimit-Reset e Retry-After.
Falha no provedor upstream (OpenAI, Anthropic, Replicate) ou erro interno.
Headers de rate limit
Presentes em toda resposta de /v1/*.
- X-RateLimit-Limit — teto por minuto da chave
- X-RateLimit-Remaining — quanto ainda resta na janela atual
- X-RateLimit-Reset — timestamp unix de quando a janela reseta
Veja o limite padrão por minuto e o custo em créditos de cada capacidade.
Ver limites