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

[Home](/it/) / [Documentazione](/it/docs/) / Autenticazione 

# Autenticazione 

Come inviare la chiave, quale header richiede ciascun formato e come proteggere le chiavi. 

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

Ogni richiesta necessita di una chiave API creata nella tua dashboard. Le chiavi iniziano con sk- e utilizzano i permessi e il saldo dell'account che le ha create. 

## Due header, una chiave 

La stessa chiave funziona in entrambi i formati: cambia solo il nome dell'header. 

 | Formato | Endpoint | Header

 | Anthropic | /v1/messages | x-api-key: sk-...

 | Anthropic (alt) | /v1/messages | Authorization: Bearer sk-...

 | OpenAI | /v1/chat/completions | Authorization: Bearer sk-... 

Il formato Anthropic richiede anche un header di versione. Ogni SDK Anthropic lo imposta automaticamente: 

```
Copy-H "anthropic-version: 2023-06-01"
```

## Variabili d'ambiente 

La maggior parte degli strumenti legge queste variabili anziché ricevere una chiave come argomento: 

 | Variabile | Utilizzata da | Valore

 | ANTHROPIC_BASE_URL | Claude Code, SDK Anthropic | https://aiprimetech.io

 | ANTHROPIC_AUTH_TOKEN | Claude Code | il tuo sk- chiave

 | ANTHROPIC_API_KEY | SDK Anthropic (Python/TS) | il tuo sk- chiave

 | OPENAI_BASE_URL | SDK OpenAI, LangChain, LiteLLM | https://aiprimetech.io/v1

 | OPENAI_API_KEY | SDK OpenAI | il tuo sk- chiave 

Nota il campo /v1 suffisso su OPENAI_BASE_URL ma non su ANTHROPIC_BASE_URL. Questa asimmetria è presente negli SDK ufficiali, non è stata introdotta da noi: il client OpenAI aggiunge i percorsi alla base che gli fornisci, mentre il client Anthropic aggiunge /v1 autonomamente. Sbagliare questo passaggio è l'errore di configurazione più comune in assoluto. 

## Gestione sicura delle chiavi 
- Crea una una chiave separata per ogni macchina o progetto così da poterne revocare una senza interferire con le altre.
- Non inserire mai le chiavi nei commit. Usa variabili d'ambiente o un gestore di segreti; aggiungi .env a .gitignore.
- Le chiavi vengono mostrate per intero una sola volta. Sostituisci una chiave smarrita anziché tentare di recuperarla.
- Una chiave compromessa consuma il tuo saldo. Revocala immediatamente dalla dashboard: la revoca è istantanea.
- Preferisci le chiamate lato server. Una chiave inclusa in un bundle per browser o in un'app mobile è una chiave pubblica. 

## Revoca e rotazione 
- Dashboard → Chiavi API.
- Crea prima la chiave sostitutiva e distribuiscila.
- Elimina la vecchia chiave una volta trasferito il traffico. Le richieste in corso che la utilizzano falliscono immediatamente dopo l'eliminazione. 

[Avvio rapidoEffettua la prima chiamata](/it/docs/getting-started/quickstart/)[Configurazione della chiave APIDove inserire la chiave in ciascuno strumento](/it/docs/guides/api-key-configuration/)[ErroriChe cosa significano 401 e 402](/it/docs/api-reference/errors/) 

[PrecedenteAvvio rapido](/it/docs/getting-started/quickstart/)[AvantiModelli e gruppi di chiavi](/it/docs/getting-started/models/)