Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De omgevingsvariabele XAI_API_KEY

Les 3 van 14 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Bewaar uw sleutel veilig
  2. Stel XAI_API_KEY in
  3. Controleer de configuratie
  4. Productieomgevingen
  5. Veelgemaakte fouten
  6. Belangrijkste punten

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 syntaxis XAI_API_KEY = waarde met 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 .env toe aan de .gitignore van al uw projecten
  • Gebruik in productie de ingebouwde secrets van uw hostingplatform