Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Okoljska spremenljivka XAI_API_KEY

Lekcija 3 od 14 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Ključ varno shrani
  2. Nastavi XAI_API_KEY
  3. Preveri konfiguracijo
  4. Produkcijska okolja
  5. Pogoste napake
  6. Ključne ugotovitve

Ključ varno shrani

Ključa API nikoli ne vključuj kot navadno besedilo v izvorno kodo. Standardni pristop je shranjevanje v okoljski spremenljivki, ki jo tvoja aplikacija prebere ob zagonu. S tem ločiš konfiguracijo od kode in zaščitiš svoje skrivnosti.

Nastavi XAI_API_KEY

Konvencija, ki jo uporabljata xAI in vsi uradni kompleti SDK, je spremenljivka XAI_API_KEY. Tako jo nastaviš v svojem sistemu.

Linux in macOS

V terminalu dodaj spremenljivko v profil svoje lupine:

echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc

Za Zsh (privzeto v macOS) zamenjaj .bashrc z .zshrc.

Windows (PowerShell)

$env:XAI_API_KEY = "xai-your-key-here"

Za trajno nastavitev uporabi sistemske okoljske spremenljivke prek naprednih nastavitev ali zaženi:

[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")

Datoteka .env (lokalni projekti)

Za projekte, ki uporabljajo ogrodje (Node.js, Django, Flask), ustvari datoteko .env v korenski mapi:

XAI_API_KEY=xai-your-key-here

Datoteko .env moraš dodati v datoteko .gitignore, da svojih skrivnosti ne bi pomotoma potisnil v skladišče Git:

# .gitignore
.env
.env.local
.env.*.local

Preveri konfiguracijo

Preveri, ali je spremenljivka na voljo:

echo $XAI_API_KEY

Prikazati se mora tvoj ključ. Če ukaz vrne prazno vrstico, ponovno naloži profil lupine ali znova zaženi terminal.

V Pythonu to preveriš takole:

import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")

Produkcijska okolja

V produkciji ne uporabljaj datoteke .env. Namesto tega uporabi vgrajene mehanizme svoje platforme:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: skrivnost (Secret), nameščena kot okoljska spremenljivka
  • Vercel / Netlify / Railway: spremenljivke na nadzorni plošči projekta
  • GitHub Actions: skrivnosti skladišča (${{ secrets.XAI_API_KEY }})

Ti sistemi šifrirajo skrivnosti v mirovanju in jih vstavijo le med izvajanjem.

Pogoste napake

  • Dodatni narekovaji v ključu: če tvoja spremenljivka vsebuje dobesedne narekovaje, bodo zahtevke spodletele z napako avtentikacije
  • Spremenljivka nastavljena v drugi lupini: spremenljivke iz enega terminala niso na voljo v drugem, razen če so izvožene v tvojem profilu
  • Presledki okoli znaka =: v datoteki .env lahko sintaksa XAI_API_KEY = vrednost s presledki odpove, odvisno od uporabljene knjižnice

Ključne ugotovitve

  • Uporabi spremenljivko XAI_API_KEY, ki jo prepozna vsak xAI SDK
  • Ključa nikoli ne vgrajuj neposredno v izvorno kodo
  • Dodaj .env v datoteko .gitignore vseh svojih projektov
  • V produkciji uporabi vgrajene mehanizme za skrivnosti svoje gostiteljske platforme