Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Il-varjabbli tal-ambjent XAI_API_KEY

Lezzjoni 3 / 14 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Aħżen iċ-ċavetta tiegħek b’mod sikur
  2. Ipprova XAI_API_KEY
  3. Iċċekkja l-konfigurazzjoni
  4. Ambjenti ta’ produzzjoni
  5. Żbalji komuni
  6. Punti Ewlenin

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-sintassi XAI_API_KEY = value b’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 .env fil-.gitignore tal-proġetti kollha tiegħek
  • Fil-produzzjoni, uża s-sigrieti integrati tal-pjattaforma ta’ hosting tiegħek