ai2saveai2save

Errori comuni e risoluzione dei problemi di accesso

401 / invalid_api_key

Verifica che la richiesta venga inviata al Base URL di questo sito e che Authorization utilizzi Bearer sk-.... Controlla che la chiave sia completa, non sia stata revocata e appartenga al gruppo corretto.

404 / modello non trovato

Controlla, nell'ordine, l'ID del modello, l'indirizzo del protocollo e il gruppo della chiave. OpenAI Compatible usa generalmente un indirizzo con /v1; Claude Code usa generalmente l'indirizzo di base senza /v1.

403 o blocco del controllo dei rischi

Imposta un User-Agent esplicito negli script per ridurre il rischio che il gateway blocchi richieste con User-Agent vuoto. Non tentare di aggirare le restrizioni ripetendo continuamente le richieste.

Richieste lente

Prova prima con domande brevi. Se le domande brevi sono veloci ma le attività complesse sono lente, la causa è generalmente la lunghezza del contesto o il tempo di inferenza del modello. Se anche le domande brevi sono lente, controlla la rete locale, la connessione e lo stato del servizio.

Connesso, ma il client non mostra modifiche

Chiudi completamente il client e riaprilo. Verifica la presenza di più file di configurazione, variabili d'ambiente precedenti che sovrascrivono le nuove impostazioni o un fornitore non effettivamente abilitato in CC Switch.

Controlli prima dell'avvio

  • Verifica chiave, Base URL e modello con una richiesta minima.
  • Imposta limiti per timeout, tentativi, concorrenza e budget.
  • Prepara connessioni o modelli di riserva.
  • Oscura i dati sensibili nei log; non registrare mai la chiave completa.