Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Mainīgo lielumu XAI_API_KEY vidē

Nodarbība 3 no 14 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Glabā savu atslēgu droši
  2. Iestati XAI_API_KEY
  3. Pārbaudi konfigurāciju
  4. Darbības vides ražošanā
  5. Biežākās kļūdas
  6. Galvenās atziņas

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 =: .env failā sintakse XAI_API_KEY = value ar 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 .env visu savu projektu .gitignore failam
  • Ražošanas vidē izmanto savas mitināšanas platformas iebūvētos noslēpumu pārvaldības rīkus