Erros comuns

Cada guia de ferramenta lista apenas os erros específicos dessa ferramenta. Estes podem acontecer com qualquer ferramenta. Verifique primeiro o código de estado ou a palavra-chave no erro e depois consulte a tabela abaixo:

Erro	Causa	Resolução
401 / invalid api key	A chave está incompleta, tem espaços antes ou depois, ou copiou o valor mascarado apresentado	Vá a API Keys, clique no ícone de copiar e copie novamente a HiAPI API key completa
O erro menciona saldo, quota ou um limite de gastos	O saldo da conta é demasiado baixo, ou o limite de gastos desta chave está esgotado	Recarregue em Saldo da conta, ou aumente o limite de gastos desta chave na página API Keys
403	Esta chave não tem permissão para o modelo	Verifique o grupo e as permissões da chave; consulte Autenticação
404 / model not available	O Base URL tem um /v1 a mais ou a menos, ou o nome do modelo está mal escrito	Confirme o URL em Base URL e protocolos; copie o nome do modelo da lista de modelos de texto
400 does not support this endpoint	O protocolo selecionado na ferramenta não é suportado por este modelo	Experimente outro protocolo (por exemplo, use Anthropic Messages para o Claude), ou mude para outro modelo
400 stream must be true / carregamento infinito	O modelo só suporta streaming e a ferramenta enviou um pedido sem streaming	Ative o streaming na ferramenta. Se o botão «Check» ou «Test connection» da ferramenta devolver este erro, ignore-o e guie-se por uma conversa real
429	Demasiados pedidos ou demasiada concorrência	Aguarde e tente novamente, e execute menos tarefas ao mesmo tempo; se o erro mencionar quota, siga a linha «saldo, quota» acima
500 / 502 / 503	O serviço do modelo falhou temporariamente	Aguarde um ou dois minutos e tente novamente; se persistir, experimente primeiro outro modelo e depois contacte-nos
Tempo limite / resposta interrompida	A rede ou um proxy bloqueou a ligação de longa duração	Verifique as regras de rede e proxy para api.hiapi.ai e tente novamente

Consultar o registo de pedidos antes de tentar novamente

Uma tarefa de agente pode já ter terminado no servidor e só a ligação da ferramenta ter caído. Antes de tentar novamente, consulte Registos de pedidos para ver se este pedido foi bem-sucedido e quanto custou, para não pagar duas vezes pelo mesmo trabalho.

Ainda com problemas

Submeta um ticket em Contacte-nos com as informações abaixo; ajuda-nos a localizar o problema mais depressa:

• A hora do erro (ao minuto)
• A ferramenta e a versão que utilizou, por exemplo Claude Code 2.1.284
• O nome do modelo e o Base URL
• O texto original do erro ou uma captura de ecrã

Oculte a chave de API antes de tirar uma captura de ecrã e nunca envie a chave a ninguém, incluindo ao apoio.