Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Premenná prostredia XAI_API_KEY

Lekcia 3 z 14 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Bezpečné uloženie kľúča
  2. Nastavenie premennej XAI_API_KEY
  3. Overenie konfigurácie
  4. Produkčné prostredia
  5. Časté chyby
  6. Kľúčové poznatky

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 .env môže syntax XAI_API_KEY = hodnota s 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 .env do súboru .gitignore vo všetkých svojich projektoch
  • V produkčnom prostredí používajte vstavané správy tajomstiev vašej hostingovej platformy