Die Umgebungsvariable XAI_API_KEY
Auf dieser Seite
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 SyntaxXAI_API_KEY = valuemit 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
.envzur.gitignore-Datei aller Ihrer Projekte hinzu - Nutzen Sie in der Produktion die integrierten Secrets Ihrer Hosting-Plattform