Source: https://aiprimetech.io/it/docs/getting-started/base-urls/

[Home](/it/) / [Documentazione](/it/docs/) / URL di base 

# URL di base 

L'impostazione che mette tutti in difficoltà: quale URL si aspetta ogni client, con e senza il suffisso /v1. 

 Copia pagina [ Visualizza in Markdown](/it/docs/getting-started/base-urls.md) [ Chiedi a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/getting-started/base-urls.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/getting-started/base-urls.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

Quasi ogni integrazione non riuscita dipende da un errore nell'URL di base. Questa pagina è il riferimento per sapere esattamente cosa impostare. 

## La regola 

 | Client | Imposta l'URL di base su | Quindi chiama

 | SDK Anthropic (Python / TS) | https://aiprimetech.io | https://aiprimetech.io/v1/messages

 | Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages

 | SDK OpenAI (Python / TS) | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions

 | LangChain / LiteLLM / Cursor | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions 

Client Anthropic: senza /v1. Client OpenAI: con /v1. L'SDK Anthropic aggiunge /v1/messages a qualsiasi URL di base fornito; l'SDK OpenAI aggiunge solo /chat/completions. Aggiungere /v1 a un URL di base Anthropic genera richieste a /v1/v1/messages, che restituisce un errore 404. 

## Come capire quale errore hai commesso 

 | Vedi | Significato

 | 404 e il percorso contiene /v1/v1/ | Hai aggiunto /v1 a un URL di base in stile Anthropic. Rimuovilo.

 | 404 su /chat/completions senza /v1 | Hai omesso /v1 da un URL di base in stile OpenAI. Aggiungilo.

 | 404 su /v1/chat/completions da uno strumento Anthropic | Lo strumento usa Messages, non Chat Completions. Usa l'URL di base e l'endpoint Anthropic.

 | La connessione funziona, ma ogni chiamata restituisce un errore 401 | L'URL è corretto, ma l'header di autenticazione è errato per quel formato. Vedi [Autenticazione](/it/docs/getting-started/authentication/). 

## Verifica senza SDK 

Questo è il modo più rapido per verificare che l'URL e la chiave siano corretti prima di attribuire il problema al framework: 

```
Copy"c"># should return JSON with a "data" array of model ids
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $CLAUDEAPIKEY"
```

A 200 significa che sia l'URL sia la chiave sono corretti e che qualsiasi problema residuo riguarda la configurazione del client. 

[AutenticazioneHeader e variabili d'ambiente](/it/docs/getting-started/authentication/)[Risoluzione dei problemiDebug a partire dai sintomi](/it/docs/guides/troubleshooting/)[PanoramicaRiferimento degli endpoint](/it/docs/api-reference/overview/) 

[PrecedenteModelli e gruppi di chiavi](/it/docs/getting-started/models/)[AvantiLa tua prima richiesta spiegata](/it/docs/getting-started/first-request/)