Proměnná prostředí XAI_API_KEY
Na této stránce
Bezpečné uložení klíče
Klíč API se nikdy nesmí objevit v čistém textu přímo ve zdrojovém kódu. Standardním postupem je uložit jej do proměnné prostředí, kterou si vaše aplikace načte při spuštění. Tím oddělíte konfiguraci od kódu a ochráníte svá tajemství.
Nastavení XAI_API_KEY
Konvence používaná společností xAI a všemi oficiálními SDK je proměnná XAI_API_KEY. Zde je návod, jak ji nastavit ve vašem systému.
Linux a macOS
V terminálu přidejte proměnnou do profilu svého shellu:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Pro Zsh (výchozí na macOS) nahraďte .bashrc souborem .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Chcete-li nastavení trvalé, použijte systémové proměnné prostředí v pokročilém nastavení, nebo spusťte:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
Soubor .env (lokální projekty)
U projektů využívajících framework (Node.js, Django, Flask) vytvořte v kořenovém adresáři soubor .env:
XAI_API_KEY=xai-your-key-here
Musíte přidat .env do souboru .gitignore, abyste náhodně neodeslali svá tajemství do úložiště Git:
# .gitignore
.env
.env.local
.env.*.local
Ověření konfigurace
Otestujte, zda je proměnná dostupná:
echo $XAI_API_KEY
Měli byste vidět svůj klíč. Pokud příkaz vrátí prázdný řádek, znovu načtěte profil shellu nebo restartujte terminál.
V Pythonu to můžete ověřit takto:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Produkční prostředí
V produkci nepoužívejte soubor .env. Místo toho využijte vestavěné mechanismy své platformy:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: Tajemství (Secret) připojené jako proměnná prostředí
- Vercel / Netlify / Railway: proměnné v dashboardu projektu
- GitHub Actions: tajemství úložiště (
${{ secrets.XAI_API_KEY }})
Tyto systémy šifrují tajemství v klidovém stavu a vkládají je pouze za běhu aplikace.
Časté chyby
- Extra uvozovky v klíči: pokud vaše proměnná obsahuje doslovné uvozovky, požadavky selžou s chybou ověření
- Proměnná nastavená v jiném shellu: proměnné z jednoho terminálu nejsou dostupné v jiném, pokud nejsou exportovány ve vašem profilu
- Mezery kolem znaménka
=: v souboru.envmůže syntaxeXAI_API_KEY = hodnotas mezerami selhat v závislosti na použité knihovně
Klíčové poznatky
- Používejte proměnnou
XAI_API_KEY, kterou rozpoznává každé SDK od xAI - Nikdy neukládejte klíč natvrdo ve zdrojovém kódu
- Přidejte
.envdo.gitignoreve všech svých projektech - V produkci používejte vestavěné správy tajemství vaší hostovací platformy