Okoljska spremenljivka XAI_API_KEY
Na tej strani
Ključ varno shrani
Ključa API nikoli ne vključuj kot navadno besedilo v izvorno kodo. Standardni pristop je shranjevanje v okoljski spremenljivki, ki jo tvoja aplikacija prebere ob zagonu. S tem ločiš konfiguracijo od kode in zaščitiš svoje skrivnosti.
Nastavi XAI_API_KEY
Konvencija, ki jo uporabljata xAI in vsi uradni kompleti SDK, je spremenljivka XAI_API_KEY. Tako jo nastaviš v svojem sistemu.
Linux in macOS
V terminalu dodaj spremenljivko v profil svoje lupine:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Za Zsh (privzeto v macOS) zamenjaj .bashrc z .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Za trajno nastavitev uporabi sistemske okoljske spremenljivke prek naprednih nastavitev ali zaženi:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
Datoteka .env (lokalni projekti)
Za projekte, ki uporabljajo ogrodje (Node.js, Django, Flask), ustvari datoteko .env v korenski mapi:
XAI_API_KEY=xai-your-key-here
Datoteko .env moraš dodati v datoteko .gitignore, da svojih skrivnosti ne bi pomotoma potisnil v skladišče Git:
# .gitignore
.env
.env.local
.env.*.local
Preveri konfiguracijo
Preveri, ali je spremenljivka na voljo:
echo $XAI_API_KEY
Prikazati se mora tvoj ključ. Če ukaz vrne prazno vrstico, ponovno naloži profil lupine ali znova zaženi terminal.
V Pythonu to preveriš takole:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Produkcijska okolja
V produkciji ne uporabljaj datoteke .env. Namesto tega uporabi vgrajene mehanizme svoje platforme:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: skrivnost (Secret), nameščena kot okoljska spremenljivka
- Vercel / Netlify / Railway: spremenljivke na nadzorni plošči projekta
- GitHub Actions: skrivnosti skladišča (
${{ secrets.XAI_API_KEY }})
Ti sistemi šifrirajo skrivnosti v mirovanju in jih vstavijo le med izvajanjem.
Pogoste napake
- Dodatni narekovaji v ključu: če tvoja spremenljivka vsebuje dobesedne narekovaje, bodo zahtevke spodletele z napako avtentikacije
- Spremenljivka nastavljena v drugi lupini: spremenljivke iz enega terminala niso na voljo v drugem, razen če so izvožene v tvojem profilu
- Presledki okoli znaka
=: v datoteki.envlahko sintaksaXAI_API_KEY = vrednosts presledki odpove, odvisno od uporabljene knjižnice
Ključne ugotovitve
- Uporabi spremenljivko
XAI_API_KEY, ki jo prepozna vsak xAI SDK - Ključa nikoli ne vgrajuj neposredno v izvorno kodo
- Dodaj
.envv datoteko.gitignorevseh svojih projektov - V produkciji uporabi vgrajene mehanizme za skrivnosti svoje gostiteljske platforme