In questa pagina
Errori comuni
Errori che qualsiasi strumento per agenti può incontrare quando si collega a HiAPI e come risolverli.
Ogni guida dello strumento elenca solo gli errori specifici di quello strumento. Questi possono verificarsi con qualsiasi strumento. Controlla prima il codice di stato o la parola chiave nell’errore, poi cercalo nella tabella seguente:
| Errore | Causa | Soluzione |
|---|---|---|
| 401 / invalid api key | La chiave è incompleta, ha spazi prima o dopo, oppure hai copiato il valore mascherato visualizzato | Vai a API Keys, fai clic sull’icona di copia e copia di nuovo la chiave API HiAPI completa |
| L’errore parla di saldo, quota o limite di spesa | Il saldo dell’account è troppo basso, oppure il limite di spesa di questa chiave è esaurito | Ricarica da Saldo dell’account, oppure aumenta il limite di spesa di questa chiave nella pagina API Keys |
| 403 | Questa chiave non ha i permessi per il modello | Controlla il gruppo e i permessi della chiave, vedi Autenticazione |
| 404 / model not available | Il Base URL ha un /v1 in più o in meno, oppure il nome del modello è scritto male | Confronta l’URL con Base URL e protocolli; copia il nome del modello dall’elenco dei modelli testuali |
| 400 does not support this endpoint | Il protocollo selezionato nello strumento non è supportato da questo modello | Prova un altro protocollo (per esempio, usa Anthropic Messages per Claude) o passa a un altro modello |
| 400 stream must be true / caricamento infinito | Il modello funziona solo in streaming e lo strumento ha inviato una richiesta non in streaming | Attiva lo streaming nello strumento. Se il pulsante “Check” o “Test connection” dello strumento restituisce questo errore, ignoralo e verifica con una chat reale |
| 429 | Troppe richieste o troppa concorrenza | Aspetta e riprova, ed esegui meno attività contemporaneamente; se l’errore parla di una quota, segui la riga “saldo, quota” qui sopra |
| 500 / 502 / 503 | Il servizio del modello ha avuto un guasto temporaneo | Aspetta un paio di minuti e riprova; se continua, prova prima un altro modello, poi contattaci |
| Timeout / risposta interrotta | La rete o un proxy ha bloccato la connessione di lunga durata | Controlla le regole di rete e proxy per api.hiapi.ai, poi riprova |
Controlla il registro delle richieste prima di riprovare
Un’attività dell’agente potrebbe essersi già conclusa sul server, con solo la connessione dello strumento interrotta. Prima di riprovare, controlla i Registri delle richieste per vedere se questa richiesta è riuscita e quanto è costata, così non paghi due volte per lo stesso lavoro.
Ancora bloccato
Apri un ticket da Contattaci con le informazioni seguenti; ci aiutano a individuare il problema più in fretta:
- L’ora dell’errore (al minuto)
- Lo strumento e la versione usati, per esempio Claude Code 2.1.284
- Il nome del modello e il Base URL
- Il testo originale dell’errore o uno screenshot
Maschera la chiave API prima di fare lo screenshot e non inviare mai la chiave a nessuno, nemmeno all’assistenza.