A XAI_API_KEY környezeti változó
Ezen az oldalon
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.envfájlban azXAI_API_KEY = értékszintaxis 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_KEYvá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
.envfájlt minden projekted.gitignoreállományához - Éles környezetben használd a hoszting platformod beépített titokkezelőjét