Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

A XAI_API_KEY környezeti változó

3. lecke 14 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Tárold biztonságosan a kulcsodat
  2. A XAI_API_KEY beállítása
  3. A konfiguráció ellenőrzése
  4. Éles környezetek
  5. Gyakori hibák
  6. Főbb megállapítások

Tárold biztonságosan a kulcsodat

Az API-kulcs soha nem szerepelhet nyílt szövegként a forráskódban. A szabványos megoldás az, hogy egy környezeti változóban tárolod, amelyet az alkalmazásod induláskor olvas be. Ez elválasztja a konfigurációt a kódtól, és megvédi a titkos adataidat.

A XAI_API_KEY beállítása

Az xAI és az összes hivatalos SDK által használt konvenció az XAI_API_KEY változó. Íme, hogyan állíthatod be a rendszereden.

Linux és macOS

A terminálban add hozzá a változót a shell profilodhoz:

echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc

Zsh esetén (ami alapértelmezett macOS-en), cseréld le a .bashrc fájlt .zshrc-re.

Windows (PowerShell)

$env:XAI_API_KEY = "xai-your-key-here"

Ha tartósan szeretnéd beállítani, használd a rendszer környezeti változóit a Speciális beállításokon keresztül, vagy futtasd a következőt:

[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")

.env fájl (helyi projektek)

Olyan projektekhez, amelyek keretrendszert használnak (Node.js, Django, Flask), hozz létre egy .env fájlt a gyökérkönyvtárban:

XAI_API_KEY=xai-your-key-here

Kötelező hozzáadnod a .env fájlt a .gitignore fájlhoz, hogy ne töltsd fel a titkos adataidat egy Git tárolóba:

# .gitignore
.env
.env.local
.env.*.local

A konfiguráció ellenőrzése

Teszteld, hogy a változó elérhető-e:

echo $XAI_API_KEY

Látnod kell a kulcsodat. Ha a parancs üres sort ad vissza, töltsd újra a shell profilodat, vagy indítsd újra a terminált.

Pythonban így ellenőrizheted:

import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")

Éles környezetek

Éles környezetben ne használj .env fájlt. Ehelyett a platformod beépített mechanizmusait használd:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: egy Secret, amely környezeti változóként van csatolva
  • Vercel / Netlify / Railway: változók a projekt irányítópultján
  • GitHub Actions: tároló titkok (${{ secrets.XAI_API_KEY }})

Ezek a rendszerek titkosítják a titkos adatokat nyugalmi állapotban, és csak futásidőben injektálják azokat.

Gyakori hibák

  • Többlet idézőjelek a kulcsban: ha a változód szó szerinti idézőjeleket tartalmaz, a kérések hitelesítési hibával meghiúsulnak
  • Másik shellben beállított változó: az egyik terminálból származó változók nem érhetők el egy másikban, hacsak nincsenek exportálva a profilodban
  • Szóközök az = jel körül: egy .env fájlban az XAI_API_KEY = érték szintaxis szóközökkel a használt könyvtártól függően meghiusulhat

Főbb megállapítások

  • Használd az XAI_API_KEY változót, amelyet minden xAI SDK felismer
  • Soha ne kódold bele keményen (hard-code) a kulcsot a forráskódba
  • Add hozzá a .env fájlt minden projekted .gitignore állományához
  • Éles környezetben használd a hoszting platformod beépített titokkezelőjét