Risoluzione dei problemi
Indice organizzato per sintomi: trova ciò che stai riscontrando e passa direttamente alla causa.
Verifica l'accesso prima di riprovare
- Verifica che l'abilitazione prevista sia attiva e annotane la scadenza.
- Verifica che la chiave utilizzi il gruppo previsto. I piani Claude a tempo utilizzano Claude Unlimited; l'accesso a Codex è separato.
- Elenca i modelli con la stessa chiave, seleziona un ID restituito e invia una richiesta di piccole dimensioni.
Usa Modelli e gruppi di chiavi oppure la checklist di configurazione dell'agente se non sai quale passaggio non è riuscito.
Non funziona nulla
Verifica il funzionamento di base prima di analizzare qualsiasi altro problema:
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"Dopo aver ricevuto correttamente una risposta con l'elenco dei modelli, verifica che il modello selezionato sia presente nell'elenco e invia una richiesta di generazione di piccole dimensioni. La generazione può comunque fallire a causa della disponibilità del modello, dell'abilitazione, dei limiti o della configurazione del client.
Per sintomo
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
404 a ogni chiamata | L'URL di base ha una gestione errata di /v1 gestione | URL di base |
401 con una chiave appena creata | Header errato per il formato oppure uno spazio finale | Autenticazione |
402 | Crediti esauriti oppure piano scaduto | Ricarica · Piani |
400 max_tokens | Messages richiede max_tokens; Chat Completions no | Messages |
model_not_found | ID errato, gruppo della chiave errato oppure modello non disponibile per quella chiave | Modelli e gruppi di chiavi |
| La connessione in streaming viene stabilita ma non restituisce nulla | Parsing della struttura degli eventi dell'altro formato | Streaming |
| Risposta interrotta a metà frase | stop_reason: max_tokens | Aumenta max_tokens |
| Funziona con curl, ma non con l'SDK | L'SDK aggiunge il proprio percorso all'URL di base | URL di base |
| L'utilizzo non compare nella dashboard | Le richieste vengono inviate a una chiave o a un endpoint diverso | Controlla ANTHROPIC_API_KEY non è impostato — Claude Code |
Frequenti 429 | Parallelismo dell'agente troppo elevato | Limiti di frequenza |
| Costo superiore al previsto | Crescita del contesto tra i turni | Gestione del contesto |
Leggere il corpo dell'errore
Il codice di stato indica la categoria del problema; i error.type e error.message campi indicano quale sia. Registra l'intero corpo — un 400 con "missing max_tokens" e un 400 con "invalid role" richiedono soluzioni completamente diverse.
Il problema persiste
Contatta support@aiprimetech.io indicando l'endpoint, l'ID del modello, il codice di stato e il corpo dell'errore. Non includere mai la tua chiave API: se l'hai già incollata da qualche parte, revocala prima.