Mainīgo lielumu XAI_API_KEY vidē
Šajā lapā
Glabā savu atslēgu droši
API atslēgai nekad nevajadzētu parādīties kā parastam tekstam tavā pirmkodā. Standarta pieeja ir glabāt to vides mainīgajā, ko tava lietotne nolasī startēšanas brīdī. Tas atdala konfigurāciju no koda un aizsargā tavus noslēpumus.
Iestati XAI_API_KEY
Konvencija, ko izmanto xAI un visi oficiālie SDK, ir mainīgais XAI_API_KEY. Lūk, kā to iestatīt savā sistēmā.
Linux un macOS
Terminālī pievieno mainīgo savam čaulas profilam:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Ja lieto Zsh (noklusējums macOS), aizstāj .bashrc ar .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Lai padarītu to pastāvīgu, izmanto sistēmas vides mainīgos, dodoties uz papildu iestatījumiem, vai palaid:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
.env fails (lokāliem projektiem)
Projektiem, kas izmanto ietvaru (Node.js, Django, Flask), izveido .env failu saknes direktorijā:
XAI_API_KEY=xai-your-key-here
Tev ir jāpievieno .env savam .gitignore failam, lai nejauši neaugšupielādētu savus noslēpumus uz Git repozitoriju:
# .gitignore
.env
.env.local
.env.*.local
Pārbaudi konfigurāciju
Pārbaudi, vai mainīgais ir pieejams:
echo $XAI_API_KEY
Tev vajadzētu redzēt savu atslēgu. Ja komanda atgriež tukšu rindu, pārlādē savu čaulas profilu vai restartē termināli.
Python valodā to vari pārbaudīt šādi:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Darbības vides ražošanā
Ražošanas vidē nelieto .env failu. Tā vietā izmanto savas platformas iebūvētos mehānismus:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: noslēpums (Secret), kas montēts kā vides mainīgais
- Vercel / Netlify / Railway: mainīgie projekta informācijas panelī
- GitHub Actions: repozitorija noslēpumi (
${{ secrets.XAI_API_KEY }})
Šīs sistēmas šifrē noslēpumus miera stāvoklī un injicē tos tikai izpildes laikā.
Biežākās kļūdas
- Liekvas pēdiņas atslēgā: ja tavs mainīgais satur burtiskas pēdiņas, pieprasījumi neizdosies autentifikācijas kļūdas dēļ
- Mainīgais iestatīts citā čaulā: mainīgie no viena termināļa nav pieejami citā, ja vien tie nav eksportēti tavā profilā
- Atstarpes ap zīmi
=:.envfailā sintakseXAI_API_KEY = valuear atstarpēm var neizdoties atkarībā no izmantotās bibliotēkas
Galvenās atziņas
- Izmanto mainīgo
XAI_API_KEY, ko atpazīst katrs xAI SDK - Nekad neiekodē atslēgu tieši savā pirmkodā
- Pievieno
.envvisu savu projektu.gitignorefailam - Ražošanas vidē izmanto savas mitināšanas platformas iebūvētos noslēpumu pārvaldības rīkus