La variabile d'ambiente XAI_API_KEY
In questa pagina
Archivia la tua chiave in sicurezza
Una chiave API non deve mai apparire in chiaro nel tuo codice sorgente. L’approccio standard consiste nell’archiviarla in una variabile d’ambiente che la tua applicazione legge all’avvio. Questo separa la configurazione dal codice e protegge i tuoi segreti.
Imposta XAI_API_KEY
La convenzione utilizzata da xAI e da tutti gli SDK ufficiali è la variabile XAI_API_KEY. Ecco come impostarla sul tuo sistema.
Linux e macOS
Nel tuo terminale, aggiungi la variabile al profilo della shell:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Per Zsh (il predefinito su macOS), sostituisci .bashrc con .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Per renderla permanente, utilizza le variabili d’ambiente di sistema tramite le impostazioni avanzate, oppure esegui:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
File .env (progetti locali)
Per i progetti che utilizzano un framework (Node.js, Django, Flask), crea un file .env nella root:
XAI_API_KEY=xai-your-key-here
Devi aggiungere .env al tuo file .gitignore per evitare di inviare i tuoi segreti a un repository Git:
# .gitignore
.env
.env.local
.env.*.local
Verifica la configurazione
Testa che la variabile sia disponibile:
echo $XAI_API_KEY
Dovresti vedere la tua chiave. Se il comando restituisce una riga vuota, ricarica il profilo della shell o riavvia il terminale.
In Python, puoi verificarla così:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Ambienti di produzione
In produzione, non usare un file .env. Utilizza invece i meccanismi integrati della tua piattaforma:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: un Secret montato come variabile d’ambiente
- Vercel / Netlify / Railway: variabili nella dashboard del progetto
- GitHub Actions: segreti del repository (
${{ secrets.XAI_API_KEY }})
Questi sistemi cifrano i segreti a riposo e li iniettano solo al momento dell’esecuzione.
Errori comuni
- Virgolette extra nella chiave: se la tua variabile contiene virgolette letterali, le richieste falliranno con un errore di autenticazione
- Variabile impostata in un’altra shell: le variabili da un terminale non sono disponibili in un altro a meno che non siano esportate nel tuo profilo
- Spazi attorno al segno
=: in un file.env, la sintassiXAI_API_KEY = valuecon spazi potrebbe fallire a seconda della libreria che utilizzi
Punti chiave
- Usa la variabile
XAI_API_KEY, riconosciuta da ogni SDK xAI - Non inserire mai la chiave direttamente nel tuo codice sorgente
- Aggiungi
.enval.gitignoredi tutti i tuoi progetti - In produzione, usa i segreti integrati della tua piattaforma di hosting