Premenná prostredia XAI_API_KEY
Na tejto strane
Bezpečné uloženie kľúča
Kľúč API sa nikdy nesmie objavovať ako čistý text vo vašom zdrojovom kóde. Štandardným prístupom je uložiť ho do premennej prostredia, ktorú vaša aplikácia načíta pri štarte. Tým oddelíte konfiguráciu od kódu a ochránite svoje tajné údaje.
Nastavenie premennej XAI_API_KEY
Konvencia používaná spoločnosťou xAI a všetkými oficiálnymi SDK je premenná XAI_API_KEY. Tu je návod, ako ju nastaviť vo vašom systéme.
Linux a macOS
V termináli pridajte premennú do profilu vášho shellu:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Pre Zsh (predvolený shell na macOS) nahraďte .bashrc súborom .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Ak chcete nastavenie trvalé, použite systémové premenné prostredia cez Rozšírené nastavenia, alebo spustite:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
Súbor .env (lokálne projekty)
Pre projekty využívajúce framework (Node.js, Django, Flask) vytvorte v koreňovom adresári súbor .env:
XAI_API_KEY=xai-your-key-here
Musíte pridať .env do svojho súboru .gitignore, aby ste náhodou neposlali svoje tajné údaje do Git repozitára:
# .gitignore
.env
.env.local
.env.*.local
Overenie konfigurácie
Otestujte, či je premenná dostupná:
echo $XAI_API_KEY
Mali by ste vidieť svoj kľúč. Ak príkaz vráti prázdny riadok, znovu načítajte profil shellu alebo reštartujte terminál.
V Pythone to môžete overiť takto:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Produkčné prostredia
V produkčnom prostredí nepoužívajte súbor .env. Namiesto toho využite vstavané mechanizmy vašej platformy:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: Tajomstvo (Secret) namapované ako premenná prostredia
- Vercel / Netlify / Railway: premenné v dashboarde projektu
- GitHub Actions: tajomstvá repozitára (
${{ secrets.XAI_API_KEY }})
Tieto systémy šifrujú tajné údaje v pokoji a vstrekujú ich až počas behu aplikácie.
Časté chyby
- Extra úvodzovky v kľúči: ak vaša premenná obsahuje doslovné úvodzovky, požiadavky zlyhajú s chybou overenia
- Premenná nastavená v inom shelli: premenné z jedného terminálu nie sú dostupné v inom, pokiaľ nie sú exportované vo vašom profile
- Medzery okolo znamienka
=: v súbore.envmôže syntaxXAI_API_KEY = hodnotas medzerami zlyhať v závislosti od použitej knižnice
Kľúčové poznatky
- Používajte premennú
XAI_API_KEY, ktorú rozpoznáva každé xAI SDK - Nikdy neukladajte kľúč natvrdo do zdrojového kódu
- Pridajte
.envdo súboru.gitignorevo všetkých svojich projektoch - V produkčnom prostredí používajte vstavané správy tajomstiev vašej hostingovej platformy