Il-varjabbli tal-ambjent XAI_API_KEY
F'din il-paġna
Aħżen iċ-ċavetta tiegħek b’mod sikur
Ċavetta API qatt m’għandha tidher b’test ċar fil-kodiċi sors tiegħek. L-approċċ standard huwa li taħżinha f’varjabbli tal-ambjent li l-applikazzjoni tiegħek taqra meta tibda. Dan jissepara l-konfigurazzjoni mill-kodiċi u jipproteġi s-sigrieti tiegħek.
Ipprova XAI_API_KEY
Il-konvenzjoni użata minn xAI u l-SDKs uffiċjali kollha hija l-varjabbli XAI_API_KEY. Hawnhekk tara kif tistabbilixxiha fuq is-sistema tiegħek.
Linux u macOS
Fit-terminal tiegħek, żid il-varjabbli mal-profil tal-qoxra (shell profile) tiegħek:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Għal Zsh (id-default fuq macOS), ibdel .bashrc b’.zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Biex tagħmilha permanenti, uża l-varjabbli tal-ambjent tas-sistema permezz tal-issettjar Avvanzat, jew ġri:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
Fajl .env (proġetti lokali)
Għal proġetti li jużaw qafas (Node.js, Django, Flask), oħloq fajl .env fir-raġuni:
XAI_API_KEY=xai-your-key-here
Trid iżżid .env fil-fajl .gitignore tiegħek biex ma timbuttax is-sigrieti tiegħek f’repożitorju Git:
# .gitignore
.env
.env.local
.env.*.local
Iċċekkja l-konfigurazzjoni
Ittestja li l-varjabbli hija disponibbli:
echo $XAI_API_KEY
Għandek tara ċ-ċavetta tiegħek. Jekk il-kmand jirritorna linja vojta, erġa’ għabbi l-profil tal-qoxra tiegħek jew erġa’ ibda t-terminal tiegħek.
F’Python, tista’ tiċċekkja hekk:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Ambjenti ta’ produzzjoni
Fil-produzzjoni, tużax fajl .env. Minflok, uża l-mekkaniżmi integrati tal-pjattaforma tiegħek:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: Sigriet (Secret) immuntat bħala varjabbli tal-ambjent
- Vercel / Netlify / Railway: varjabbli fid-dashboard tal-proġett
- GitHub Actions: sigrieti tar-repożitorju (
${{ secrets.XAI_API_KEY }})
Dawn is-sistemi jikkriptaw is-sigrieti waqt li jkunu mistrieħa (at rest) u jinjettawhom biss waqt l-eżekuzzjoni (runtime).
Żbalji komuni
- Virgoli żejda fiċ-ċavetta: jekk il-varjabbli tiegħek fiha virgoli letterali, it-talbiet se jfallu b’żball ta’ awtentikazzjoni
- Varjabbli stabbilita f’qoxra oħra: varjabbli minn terminal wieħed mhumiex disponibbli f’ieħor sakemm ma jkunux esportati fil-profil tiegħek
- Spazji madwar is-sinjal
=: f’fajl.env, is-sintassiXAI_API_KEY = valueb’spazji tista’ tfalli skont il-librerija li tuża
Punti Ewlenin
- Uża l-varjabbli
XAI_API_KEY, rikonoxxuta minn kull SDK ta’ xAI - Qatt ma tikteb iċ-ċavetta direttament fil-kodiċi sors tiegħek
- Żid
.envfil-.gitignoretal-proġetti kollha tiegħek - Fil-produzzjoni, uża s-sigrieti integrati tal-pjattaforma ta’ hosting tiegħek