Erros

A Pixapi usa códigos de status HTTP além de tipos de erro legíveis por máquina.

Formato do erro

{
  "error": {
    "code": 400,
    "message": "xxx",
    "type": "invalid_request_error"
  }
}

Erros comuns

Status HTTP	Tipo	Significado
400	invalid_request_error	Campo de requisição ausente ou inválido.
401	unauthorized	Chave de API ausente ou inválida.
402	insufficient_credits	A conta não tem créditos suficientes.
404	model_not_found	O ID do modelo é desconhecido ou indisponível.
422	prompt_rejected	O prompt ou entrada viola a política do modelo.
429	rate_limited	Muitas requisições em um curto período.
500	internal_error	Erro inesperado do servidor.
503	model_unavailable	O provedor está temporariamente indisponível.

Orientação de repetição

Repita apenas erros transitórios:

• 429 rate_limited
• 500 internal_error
• 503 model_unavailable

Use backoff exponencial e evite repetir respostas 400, 401, 402 ou 422 sem alterar a requisição, a chave ou o estado da conta.