Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Die Umgebungsvariable XAI_API_KEY

Lektion 3 von 14 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Sichere Aufbewahrung des Schlüssels
  2. Festlegen von XAI_API_KEY
  3. Konfiguration prüfen
  4. Produktionsumgebungen
  5. Häufige Fehler
  6. Kernaussagen

Sichere Aufbewahrung des Schlüssels

Ein API-Schlüssel darf unter keinen Umständen als reiner Text in Ihrem Quellcode erscheinen. Der Standardansatz besteht darin, ihn in einer Umgebungsvariable zu speichern, die Ihre Anwendung beim Start ausliest. Dies trennt die Konfiguration vom Code und schützt Ihre Geheimnisse.

Festlegen von XAI_API_KEY

Die von xAI und allen offiziellen SDKs verwendete Konvention ist die Variable XAI_API_KEY. Hier ist die Vorgehensweise, um sie auf Ihrem System einzurichten.

Linux und macOS

Fügen Sie in Ihrem Terminal die Variable Ihrem Shell-Profil hinzu:

echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc

Für Zsh (der Standard auf macOS) ersetzen Sie .bashrc durch .zshrc.

Windows (PowerShell)

$env:XAI_API_KEY = "xai-your-key-here"

Um dies dauerhaft zu machen, verwenden Sie die Systemumgebungsvariablen über die erweiterten Einstellungen oder führen Sie aus:

[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")

.env-Datei (lokale Projekte)

Für Projekte, die ein Framework verwenden (Node.js, Django, Flask), erstellen Sie eine .env-Datei im Stammverzeichnis:

XAI_API_KEY=xai-your-key-here

Sie müssen .env in Ihrer .gitignore-Datei hinzufügen, damit Sie Ihre Geheimnisse nicht in ein Git-Repository hochladen:

# .gitignore
.env
.env.local
.env.*.local

Konfiguration prüfen

Testen Sie, ob die Variable verfügbar ist:

echo $XAI_API_KEY

Sie sollten Ihren Schlüssel sehen. Wenn der Befehl eine leere Zeile zurückgibt, laden Sie Ihr Shell-Profil neu oder starten Sie Ihr Terminal neu.

In Python können Sie dies wie folgt prüfen:

import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")

Produktionsumgebungen

In der Produktion verwenden Sie keine .env-Datei. Nutzen Sie stattdessen die integrierten Mechanismen Ihrer Plattform:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: Ein Secret, das als Umgebungsvariable eingebunden ist
  • Vercel / Netlify / Railway: Variablen im Projektdashboard
  • GitHub Actions: Repository-Secrets (${{ secrets.XAI_API_KEY }})

Diese Systeme verschlüsseln Geheimnisse im Ruhezustand und injizieren sie erst zur Laufzeit.

Häufige Fehler

  • Zusätzliche Anführungszeichen im Schlüssel: Wenn Ihre Variable wörtliche Anführungszeichen enthält, führen die Anfragen zu einem Authentifizierungsfehler
  • Variable in einer anderen Shell festgelegt: Variablen aus einem Terminal sind in einem anderen nicht verfügbar, es sei denn, sie wurden in Ihrem Profil exportiert
  • Leerzeichen um das =-Zeichen: In einer .env-Datei kann die Syntax XAI_API_KEY = value mit Leerzeichen je nach verwendetem Bibliothek fehlschlagen

Kernaussagen

  • Verwenden Sie die Variable XAI_API_KEY, die von jedem xAI SDK erkannt wird
  • Kodieren Sie den Schlüssel niemals hart im Quellcode
  • Fügen Sie .env zur .gitignore-Datei aller Ihrer Projekte hinzu
  • Nutzen Sie in der Produktion die integrierten Secrets Ihrer Hosting-Plattform