Erros & limites

A API usa códigos de status HTTP convencionais e retorna erros no formato da OpenAI.

Formato do erro

{
  "error": {
    "message": "Descrição legível do que houve.",
    "type": "invalid_request_error",
    "code": "..."
  }
}

Códigos de status

Status	Significado	Como resolver
400 Bad Request	Corpo inválido (JSON malformado, parâmetro faltando)	Confira model e messages/input
401 Unauthorized	Key ausente, inválida ou revogada	Verifique o header Authorization — ver Autenticação
403 Forbidden	Modelo não liberado no seu plano	Use um modelo do seu plano ou faça upgrade
404 Not Found	Endpoint ou modelo inexistente	Cheque a URL e o id do modelo
429 Too Many Requests	Limite de requisições/min atingido	Reduza a taxa, aplique backoff, ou suba de plano
5xx	Erro temporário no servidor	Re-tente com backoff exponencial

Limites de taxa

Cada plano tem um limite de requisições por minuto (fair-use). Ao ultrapassá-lo, a API responde 429.

Plano	Requisições/min
Free	5
Starter	15
Standard	40
Pro	120

Trate o 429 com backoff

Ao receber 429, espere e re-tente com intervalo crescente (ex. 1s, 2s, 4s). As SDKs oficiais da OpenAI já fazem retry automático com backoff.

Nota

Texto é ilimitado dentro do plano — o controle é por requisições/min, não por volume total. Imagem usa cota mensal + uso adicional. Detalhes em Preços & cotas.