URL di base
L'impostazione che mette tutti in difficoltà: quale URL si aspetta ogni client, con e senza il suffisso /v1.
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. |
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:
"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.