Códigos de Erro

Compreendendo as respostas de erro da API

Formato de Resposta de Erro
Todas as respostas de erro seguem este formato:
{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}
Códigos de Erro
400Bad Request

Os parâmetros da requisição são inválidos ou estão malformados.

Solução: Verifique o corpo da sua requisição e certifique-se de que todos os campos obrigatórios estão presentes com valores válidos.

401Unauthorized

Chave de API inválida ou ausente.

Solução: Certifique-se de que está incluindo uma chave de API válida no cabeçalho Authorization.

402Payment Required

Créditos insuficientes na sua carteira da API.

Solução: Compre mais créditos ou aguarde até que seus créditos sejam recarregados.

403Forbidden

Acesso à API não aprovado ou sua conta está suspensa.

Solução: Entre em contato com o suporte se acredita que isto é um erro.

404Not Found

O recurso solicitado (tarefa, webhook, etc.) não foi encontrado.

Solução: Verifique se o ID do recurso está correto.

429Too Many Requests

Muitas solicitações em um curto período.

Solução: Implemente backoff exponencial e respeite os limites de taxa.

500Internal Server Error

Ocorreu um problema no nosso lado.

Solução: Tente novamente a solicitação após um breve intervalo. Se o problema persistir, entre em contato com o suporte.

Limites de Taxa
Limites de taxa padrão:
MétricaLimite
Pedidos por minuto60
Pedidos por dia10,000
Tarefas simultâneas5
Nano Banana Pro API