Miljövariabeln XAI_API_KEY
På denna sida
Lagra din nyckel säkert
En API-nyckel får aldrig förekomma som vanlig text i din källkod. Standardmetoden är att lagra den i en miljövariabel som ditt program läser vid start. Detta skiljer konfiguration från kod och skyddar dina hemligheter.
Ställ in XAI_API_KEY
Konventionen som används av xAI och alla officiella SDK:n är variabeln XAI_API_KEY. Så här ställer du in den på ditt system.
Linux och macOS
Lägg till variabeln i ditt skalprofil i terminalen:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
För Zsh (standard på macOS), byt ut .bashrc mot .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
För att göra inställningen permanent använder du systemets miljövariabler via Avancerade inställningar, eller kör:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
.env-fil (lokala projekt)
För projekt som använder ett ramverk (Node.js, Django, Flask) skapar du en .env-fil i rotkatalogen:
XAI_API_KEY=xai-your-key-here
Du måste lägga till .env i din .gitignore-fil så att du inte pushar dina hemligheter till ett Git-arkiv:
# .gitignore
.env
.env.local
.env.*.local
Kontrollera konfigurationen
Testa att variabeln är tillgänglig:
echo $XAI_API_KEY
Du ska se din nyckel. Om kommandot returnerar en tom rad laddar du om din skalprofil eller startar om terminalen.
I Python kan du kontrollera det så här:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Produktionsmiljöer
Använd inte en .env-fil i produktion. Använd istället din plattforms inbyggda mekanismer:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: en Secret monterad som en miljövariabel
- Vercel / Netlify / Railway: variabler i projektets instrumentpanel
- GitHub Actions: arkivhemligheter (
${{ secrets.XAI_API_KEY }})
Dessa system krypterar hemligheter i vila och injicerar dem endast vid körning.
Vanliga misstag
- Extra citattecken i nyckeln: om din variabel innehåller bokstavliga citattecken misslyckas förfrågningar med ett autentiseringsfel
- Variabel inställd i ett annat skal: variabler från en terminal är inte tillgängliga i en annan om de inte exporteras i din profil
- Mellanslag runt likhetstecknet
=: i en.env-fil kan syntaxenXAI_API_KEY = valuemed mellanslag misslyckas beroende på vilket bibliotek du använder
Viktiga punkter
- Använd variabeln
XAI_API_KEY, som känns igen av varje xAI SDK - Hardkoda aldrig nyckeln i din källkod
- Lägg till
.envi.gitignoreför alla dina projekt - Använd din hostingplattforms inbyggda hemlighetshantering i produktion