Conexão e uso | Documentação de APIs

Quando uma chamada falhar ou uma conversa for interrompida, verifique primeiro autenticação, caminho do endpoint e disponibilidade do modelo com uma solicitação mínima.

Não consegue conectar à plataforma?

Verifique:

Se a chave API está correta, sem espaços ou quebras de linha extras.
Se a URL base está correta e sem caminhos duplicados.
Se o caminho corresponde ao protocolo do cliente, como o caminho compatível OpenAI para clientes OpenAI.
Se rede local, proxy corporativo, firewall, DNS ou inspeção HTTPS bloqueiam solicitações.
Se a chave expirou, foi excluída ou pertence a uma conta restrita.

Para chamadas compatíveis OpenAI, teste uma solicitação mínima sem streaming:

bash

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

Se a solicitação mínima falhar, normalmente há problema de rede, autenticação, configuração do caminho, permissões do modelo ou status da conta.

Modelo selecionado, mas sem resposta ou com erro?

Causas comuns:

O ID do modelo está incorreto ou não corresponde à lista da plataforma.
O modelo está temporariamente indisponível ou não é permitido para a chave.
O formato da solicitação é inválido, como nomes, aninhamento ou tipos de campos errados.
O saldo é insuficiente, o contexto ou a saída são longos demais ou o serviço excedeu o tempo limite.
O cliente de terceiros não trata streaming ou respostas de erro corretamente.

Copie o ID exato do console ou da lista, teste um corpo mínimo e adicione contexto e parâmetros gradualmente.

E se o chat apresentar erro ou desconectar?

Identifique onde ocorre a falha:

Antes do início: verifique autenticação, caminho, modelo e parâmetros.
Durante streaming: verifique timeout do cliente, cadeia de proxies e interpretação de SSE.
Com contexto ou saída longos: verifique tamanho da solicitação, limites de saída e timeout do serviço.

Tratamento recomendado:

Leia os campos específicos do erro.
Mude temporariamente para sem streaming para distinguir falha do modelo de falha na interpretação do streaming.
Adicione novas tentativas com espera progressiva para 429, instabilidade de rede e alguns erros 5xx.
Inclua o contexto necessário nas tentativas em vez de presumir estado de conversa no servidor.
Registre X-Request-ID se o problema persistir.