De omgevingsvariabele XAI_API_KEY
Op deze pagina
Bewaar uw sleutel veilig
Een API-sleutel mag nooit als platte tekst in uw broncode verschijnen. De standaardaanpak is om deze op te slaan in een omgevingsvariabele die uw applicatie bij het opstarten uitleest. Dit scheidt configuratie van code en beschermt uw geheimen.
Stel XAI_API_KEY in
De conventie die door xAI en alle officiële SDK’s wordt gebruikt, is de variabele XAI_API_KEY. Hier leest u hoe u deze op uw systeem instelt.
Linux en macOS
Voeg in uw terminal de variabele toe aan uw shell-profiel:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Voor Zsh (de standaard op macOS) vervangt u .bashrc door .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Om dit permanent te maken, gebruikt u de systeemomgevingsvariabelen via Geavanceerde instellingen, of voert u het volgende uit:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
.env-bestand (lokale projecten)
Voor projecten die een framework gebruiken (Node.js, Django, Flask), maakt u een .env-bestand in de hoofdmap:
XAI_API_KEY=xai-your-key-here
U moet .env toevoegen aan uw .gitignore-bestand zodat u uw geheimen niet naar een Git-repository pusht:
# .gitignore
.env
.env.local
.env.*.local
Controleer de configuratie
Test of de variabele beschikbaar is:
echo $XAI_API_KEY
U zou uw sleutel moeten zien. Als de opdracht een lege regel retourneert, herlaadt u uw shell-profiel of start u uw terminal opnieuw op.
In Python kunt u dit als volgt controleren:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Productieomgevingen
Gebruik in productie geen .env-bestand. Gebruik in plaats daarvan de ingebouwde mechanismen van uw platform:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: een Secret gemount als omgevingsvariabele
- Vercel / Netlify / Railway: variabelen in het projectdashboard
- GitHub Actions: repository secrets (
${{ secrets.XAI_API_KEY }})
Deze systemen versleutelen geheimen in rust en injecteren ze alleen tijdens runtime.
Veelgemaakte fouten
- Extra aanhalingstekens in de sleutel: als uw variabele letterlijke aanhalingstekens bevat, zullen verzoeken mislukken met een authenticatiefout
- Variabele ingesteld in een andere shell: variabelen uit de ene terminal zijn niet beschikbaar in een andere tenzij ze in uw profiel zijn geëxporteerd
- Spaties rond het
=-teken: in een.env-bestand kan de syntaxisXAI_API_KEY = waardemet spaties mislukken, afhankelijk van de bibliotheek die u gebruikt
Belangrijkste punten
- Gebruik de variabele
XAI_API_KEY, herkend door elke xAI SDK - Hardcode de sleutel nooit in uw broncode
- Voeg
.envtoe aan de.gitignorevan al uw projecten - Gebruik in productie de ingebouwde secrets van uw hostingplatform