Códigos de erro

Códigos de erro

Quando você encontrar erros ao chamar a API ou usar o site, consulte esta referência.

401 Unauthorized

Significado: API Key inválida.

Verificar:

  1. A Key foi copiada completamente (começa com sk-, sem espaços extras)
  2. A Key foi excluída? Confirme em Gerenciamento de API Key
  3. A variável de ambiente está ativa? (reabra o terminal)

403 Forbidden

Significado: sem permissão para acessar o recurso.

Verificar: a Key pode estar desativada ou o IP restrito. Verifique o status em Gerenciamento de API Key.

404 Not Found

Significado: modelo não encontrado ou caminho incorreto.

Verificar:

  1. O nome do modelo corresponde exatamente ao catálogo de modelos (diferencia maiúsculas de minúsculas)
  2. A Base URL inclui o sufixo /v1

429 Too Many Requests

Significado: muitas requisições — limite de taxa atingido.

Solução: aguarde alguns segundos e tente novamente; para cenários de alta frequência, adicione lógica de repetição no código.

Saldo insuficiente

Significado: o saldo da conta não é suficiente para esta chamada.

Solução: recarregue na página de recarga.

500 / 502 / 503

Significado: erro temporário do servidor.

Solução: tente novamente mais tarde. Se persistir, envie um ticket por Meus formulários.