Source: https://aiprimetech.io/it/docs/guides/troubleshooting/

[Home](/it/) / [Documentazione](/it/docs/) / Risoluzione dei problemi 

# Risoluzione dei problemi 

Indice organizzato per sintomi: trova ciò che stai riscontrando e passa direttamente alla causa. 

 Copia pagina [ Visualizza in Markdown](/it/docs/guides/troubleshooting.md) [ Chiedi a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/troubleshooting.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Chiedi in Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/troubleshooting.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

## 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](/it/docs/getting-started/models/) oppure la [checklist di configurazione dell'agente](/it/agents/) se non sai quale passaggio non è riuscito. 

## Non funziona nulla 

Verifica il funzionamento di base prima di analizzare qualsiasi altro problema: 

```
Copycurl -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](/it/docs/getting-started/base-urls/)

 | 401 con una chiave appena creata | Header errato per il formato oppure uno spazio finale | [Autenticazione](/it/docs/getting-started/authentication/)

 | 402 | Crediti esauriti oppure piano scaduto | [Ricarica](/it/topup/) · [Piani](/it/plans/)

 | 400 max_tokens | Messages richiede max_tokens; Chat Completions no | [Messages](/it/docs/api-reference/messages/)

 | model_not_found | ID errato, gruppo della chiave errato oppure modello non disponibile per quella chiave | [Modelli e gruppi di chiavi](/it/docs/getting-started/models/)

 | La connessione in streaming viene stabilita ma non restituisce nulla | Parsing della struttura degli eventi dell'altro formato | [Streaming](/it/docs/api-reference/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](/it/docs/getting-started/base-urls/)

 | 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](/it/docs/guides/claude-code/)

 | Frequenti 429 | Parallelismo dell'agente troppo elevato | [Limiti di frequenza](/it/docs/api-reference/rate-limits/)

 | Costo superiore al previsto | Crescita del contesto tra i turni | [Gestione del contesto](/it/docs/guides/context-management/) 

## 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](mailto: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. 

[ErroriRiferimento dei codici di stato](/it/docs/api-reference/errors/)[URL di baseL'errore più comune](/it/docs/getting-started/base-urls/)[Configurazione della chiave APIImpostazioni per ciascuno strumento](/it/docs/guides/api-key-configuration/) 

[PrecedenteBest practice per la produzione](/it/docs/guides/best-practices/)[AvantiPanoramica degli SDK](/it/docs/sdks/)