Miljøvariablen XAI_API_KEY
På denne side
Opbevar din nøgle sikkert
En API-nøgle må aldrig forekomme som almindelig tekst i din kildekode. Standardtilgangen er at gemme den i en miljøvariabel, som dit program læser ved opstart. Dette adskiller konfiguration fra kode og beskytter dine hemmeligheder.
Indstil XAI_API_KEY
Konventionen, som xAI og alle officielle SDK’er bruger, er variablen XAI_API_KEY. Her er fremgangsmåden for at indstille den på dit system.
Linux og macOS
Tilføj variablen til din shell-profil i terminalen:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Hvis du bruger Zsh (standard på macOS), skal du erstatte .bashrc med .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
For at gøre den permanent skal du bruge systemets miljøvariabler via Avancerede indstillinger eller køre:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
.env-fil (lokale projekter)
Til projekter, der bruger et framework (Node.js, Django, Flask), skal du oprette en .env-fil i rodmappen:
XAI_API_KEY=xai-your-key-here
Du skal tilføje .env til din .gitignore-fil, så du ikke pusher dine hemmeligheder til et Git-repository:
# .gitignore
.env
.env.local
.env.*.local
Tjek konfigurationen
Test, at variablen er tilgængelig:
echo $XAI_API_KEY
Du bør se din nøgle. Hvis kommandoen returnerer en tom linje, skal du genindlæse din shell-profil eller genstarte terminalen.
I Python kan du tjekke det sådan her:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Produktionsmiljøer
Brug ikke en .env-fil i produktion. Brug i stedet din platforms indbyggede mekanismer:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: En Secret monteret som en miljøvariabel
- Vercel / Netlify / Railway: Variabler i projektets dashboard
- GitHub Actions: Repository-hemmeligheder (
${{ secrets.XAI_API_KEY }})
Disse systemer krypterer hemmeligheder, når de er inaktive, og injicerer dem kun under kørsel.
Almindelige fejl
- Ekstra citationstegn i nøglen: Hvis din variabel indeholder bogstavelige citationstegn, vil anmodninger fejle med en autentificeringsfejl.
- Variabel indstillet i en anden shell: Variabler fra én terminal er ikke tilgængelige i en anden, medmindre de er eksporteret i din profil.
- Mellemrum omkring
=-tegnet: I en.env-fil kan syntaksenXAI_API_KEY = værdimed mellemrum fejle afhængigt af det bibliotek, du bruger.
Vigtige pointer
- Brug variablen
XAI_API_KEY, som genkendes af alle xAI SDK’er - Hardkod aldrig nøglen i din kildekode
- Tilføj
.envtil.gitignorei alle dine projekter - Brug din hosting-platforms indbyggede hemmeligheder i produktion