Versione: 18 agosto 2026
16. Gestione degli errori e risoluzione dei problemi
| Errore o sintomo | Causa probabile | Azione consigliata |
|---|---|---|
| 401 con LiteLLM_VerificationTokenTable o token_not_found_in_db | Una nuova chiave Logicc viene inviata al precedente endpoint LiteLLM. | Utilizzate https://api.logicc.cloud/v1 e rimuovete il precedente Base URL api.logicc.io. |
| 401 Authorization failed o virtual_key_not_found | La chiave manca, non è valida, è stata revocata o viene inviata nell'header errato. | Verificate la chiave completa e l'header Authorization. Richiedete una chiave sostitutiva se quella attuale funzionava in precedenza. |
| GET /v1/models funziona, ma manca un modello necessario | La chiave è valida, ma il modello o la route del provider non è abilitata per la chiave. | Inviate gli ID dei modelli richiesti al supporto Logicc. L'endpoint Models è autorevole per ogni chiave. |
| 429 o RESOURCE_EXHAUSTED | È stata raggiunta una quota di richieste, token, provider o account. | Riducete la concorrenza, riprovate con backoff esponenziale e controllate l'endpoint della quota prima di contattare il supporto. |
| messages.*.tool_use.input must be a valid dictionary | Una chiamata a uno strumento contiene una stringa, un elenco o un JSON non valido anziché un oggetto. | Assicuratevi che ogni input dello strumento sia un oggetto JSON valido, compresi gli input vuoti rappresentati da {}. |
| Function tools with reasoning_effort are not supported | Il modello selezionato non supporta questa combinazione di parametri nelle Chat Completions. | Impostate reasoning_effort su none per questa richiesta oppure utilizzate un modello e un endpoint compatibili. |
| Un client di terze parti non funziona mentre cURL funziona | Il client potrebbe sovrascrivere il Base URL, gli header, l'ID del modello o lo schema della richiesta. | Confrontate la richiesta in uscita con l'esempio cURL e verificate il supporto degli endpoint personalizzati compatibili con OpenAI. |
Per i carichi di produzione, configurate timeout espliciti di connessione e risposta, riprovate solo gli errori temporanei, limitate il numero di tentativi e preservate l'idempotenza quando una richiesta ripetuta potrebbe attivare un'azione esterna.
17. Checklist per la produzione
- Conservate la chiave in un secret manager o in una variabile d'ambiente protetta.
- Verificate il Base URL e gli header di autenticazione in ogni ambiente.
- Individuate gli ID dei modelli abilitati tramite
GET /v1/modelsdurante la configurazione. - Impostate timeout espliciti e un numero limitato di nuovi tentativi per le risposte
429e gli errori temporanei5xx. - Convalidate gli input degli strumenti come oggetti JSON prima di inviare le richieste.
- Registrate orario della richiesta, endpoint, ID del modello, codice di stato e ID della richiesta senza memorizzare dati riservati o contenuti sensibili.
- Monitorate l'endpoint della quota e i rate limit tecnici.
- Testate le funzionalità specifiche del modello, come streaming, strumenti, file, immagini e output strutturato, prima del rilascio.
- Definite un comportamento di fallback per modelli non disponibili e interruzioni dei provider.
18. Supporto
E-mail: [email protected]
Oggetto: API
Includete le seguenti informazioni per ricevere rapidamente assistenza tecnica:
- Azienda e persona di contatto
- Ambiente e versione del client o dell'SDK
- Base URL ed endpoint completo
- Identificativo del modello
- Orario approssimativo e fuso orario
- Codice di stato HTTP e corpo completo dell'errore
- Richiesta minima riproducibile dopo la rimozione di tutti i dati riservati
Help Center Logicc: https://help.logicc.com/docs
