Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Proměnná prostředí XAI_API_KEY

Lekce 3 z 14 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Bezpečné uložení klíče
  2. Nastavení XAI_API_KEY
  3. Ověření konfigurace
  4. Produkční prostředí
  5. Časté chyby
  6. Klíčové poznatky

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 .env může syntaxe XAI_API_KEY = hodnota s 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 .env do .gitignore ve všech svých projektech
  • V produkci používejte vestavěné správy tajemství vaší hostovací platformy