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:
- A Key foi copiada completamente (começa com
sk-, sem espaços extras) - A Key foi excluída? Confirme em Gerenciamento de API Key
- 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:
- O nome do modelo corresponde exatamente ao catálogo de modelos (diferencia maiúsculas de minúsculas)
- 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.