Kintamasis XAI_API_KEY aplinkoje
Šiame puslapyje
Saugiai saugok savo raktą
API raktas niekada neturi būti aiškiu tekstu tavo源代码 (source code). Standartinis būdas – saugoti jį aplinkos kintamajame, kurį tavo programa nuskaitys paleidimo metu. Tai atskiria konfigūraciją nuo kodo ir apsaugo tavo paslaptis.
Nustatyk XAI_API_KEY
„xAI“ ir visi oficialūs SDK naudoja XAI_API_KEY kintamąjį. Štai kaip jį nustatyti savo sistemoje.
Linux ir macOS
Terminale pridėk kintamąjį į savo apvalkalo (shell) profilį:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Jei naudoji Zsh (numatytasis macOS), pakeisk .bashrc į .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Kad nustatymas būtų nuolatinis, naudok sistemos aplinkos kintamuosius per išplėstinius nustatymus arba paleisk:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
.env failas (vietiniams projektams)
Projektams, naudojantiems karkasus (Node.js, Django, Flask), sukurk .env failą projekto šaknyje:
XAI_API_KEY=xai-your-key-here
Privalai įtraukti .env į savo .gitignore failą, kad nenukeltum paslapčių į „Git“ saugyklą:
# .gitignore
.env
.env.local
.env.*.local
Patikrink konfigūraciją
Įsitikink, kad kintamasis yra pasiekiamas:
echo $XAI_API_KEY
Turi matyti savo raktą. Jei komanda grąžina tuščią eilutę, iš naujo įkelk savo apvalkalo profilį arba paleisk terminalą iš naujo.
„Python“ kalboje tai patikrinti gali taip:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Gamybinės aplinkos
Gamyboje nenaudok .env failo. Vietoj to naudok savo platformos integruotus mechanizmus:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: „Secret“, prijungtas kaip aplinkos kintamasis
- Vercel / Netlify / Railway: kintamieji projekto valdymo skydelyje
- GitHub Actions: saugyklos paslaptys (
${{ secrets.XAI_API_KEY }})
Šios sistemos šifruoja paslaptis ramybės būsenoje ir įveda jas tik vykdymo metu.
Dažnos klaidos
- Papildomos kabutės rakto reikšmėje: jei tavo kintamasis turi literalių kabučių, užklausos nepavyks dėl autentifikavimo klaidos
- Kintamasis nustatytas kitame apvalkale: kintamieji iš vieno terminalo nėra prieinami kitame, nebent jie eksportuoti tavo profilyje
- Tarpai aplink ženklą
=:.envfaile sintaksėXAI_API_KEY = valuesu tarpais gali neveikti, priklausomai nuo naudojamos bibliotekos
Svarbiausi punktai
- Naudok
XAI_API_KEYkintamąjį, kurį atpažįsta kiekvienas „xAI“ SDK - Niekada neįkoduojo rakto tiesiai į源代码
- Įtrauk
.envį visų savo projektų.gitignore - Gamyboje naudok savo talpinimo platformos integruotus paslapčių valdymo įrankius