Connessione e utilizzo

Quando una chiamata fallisce o una conversazione si interrompe, verifica prima con una richiesta minima autenticazione, percorso dell’endpoint e disponibilità del modello.

Non riesci a collegarti alla piattaforma?

Controlla:

• Che la chiave API sia corretta e senza spazi o ritorni a capo aggiuntivi.
• Che l’URL di base sia corretto e non contenga percorsi duplicati.
• Che il percorso corrisponda al protocollo del client, ad esempio quello compatibile OpenAI per client OpenAI.
• Che rete locale, proxy aziendale, firewall, DNS o ispezione HTTPS non blocchino le richieste.
• Che la chiave non sia scaduta, eliminata o associata a un account limitato.

Per chiamate compatibili OpenAI, prova una richiesta minima senza streaming:

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 fallisce anche la richiesta minima, il problema è solitamente nella rete, autenticazione, configurazione del percorso, permessi dei modelli o stato dell’account.

Modello selezionato, ma nessuna risposta o un errore?

Cause comuni:

• L’ID del modello è errato o non corrisponde all’elenco della piattaforma.
• Il modello è temporaneamente indisponibile o non consentito per la chiave.
• Il formato della richiesta è invalido, ad esempio nomi, annidamento o tipi dei campi errati.
• Il saldo è insufficiente, contesto o output sono troppo lunghi oppure il servizio è andato in timeout.
• Il client di terzi non gestisce correttamente streaming o risposte di errore.

Copia l’ID esatto dalla console o dall’elenco, prova un corpo minimo e poi aggiungi gradualmente contesto e parametri.

Cosa fare se una chat dà errore o si disconnette?

Individua il punto del problema:

• Prima dell’inizio: verifica autenticazione, percorso, modello e parametri.
• Durante lo streaming: verifica timeout del client, catena di proxy e analisi SSE.
• Con contesto o output lunghi: verifica dimensioni della richiesta, limiti di output e timeout del servizio.

Gestione consigliata:

1. Leggi i campi specifici dell’errore.
2. Passa temporaneamente alla modalità senza streaming per distinguere un errore del modello da uno nell’analisi dello streaming.
3. Aggiungi tentativi con attesa progressiva per 429, instabilità della rete e alcuni errori 5xx.
4. Includi il contesto necessario nei tentativi, senza presumere uno stato della conversazione sul server.
5. Registra X-Request-ID se il problema persiste.