Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Kintamasis XAI_API_KEY aplinkoje

Paskaita 3 iš 14 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Saugiai saugok savo raktą
  2. Nustatyk XAI_API_KEY
  3. Patikrink konfigūraciją
  4. Gamybinės aplinkos
  5. Dažnos klaidos
  6. Svarbiausi punktai

Saugiai saugok savo raktą

API raktas niekada neturi būti aiškiu tekstu tavo源代码 (source code). Standartinis būdas – saugoti jį aplinkos kintamajame, kurį tavo programa nuskaitys paleidimo metu. Tai atskiria konfigūraciją nuo kodo ir apsaugo tavo paslaptis.

Nustatyk XAI_API_KEY

„xAI“ ir visi oficialūs SDK naudoja XAI_API_KEY kintamąjį. Štai kaip jį nustatyti savo sistemoje.

Linux ir macOS

Terminale pridėk kintamąjį į savo apvalkalo (shell) profilį:

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

Jei naudoji Zsh (numatytasis macOS), pakeisk .bashrc į .zshrc.

Windows (PowerShell)

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

Kad nustatymas būtų nuolatinis, naudok sistemos aplinkos kintamuosius per išplėstinius nustatymus arba paleisk:

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

.env failas (vietiniams projektams)

Projektams, naudojantiems karkasus (Node.js, Django, Flask), sukurk .env failą projekto šaknyje:

XAI_API_KEY=xai-your-key-here

Privalai įtraukti .env į savo .gitignore failą, kad nenukeltum paslapčių į „Git“ saugyklą:

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

Patikrink konfigūraciją

Įsitikink, kad kintamasis yra pasiekiamas:

echo $XAI_API_KEY

Turi matyti savo raktą. Jei komanda grąžina tuščią eilutę, iš naujo įkelk savo apvalkalo profilį arba paleisk terminalą iš naujo.

„Python“ kalboje tai patikrinti gali taip:

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

Gamybinės aplinkos

Gamyboje nenaudok .env failo. Vietoj to naudok savo platformos integruotus mechanizmus:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: „Secret“, prijungtas kaip aplinkos kintamasis
  • Vercel / Netlify / Railway: kintamieji projekto valdymo skydelyje
  • GitHub Actions: saugyklos paslaptys (${{ secrets.XAI_API_KEY }})

Šios sistemos šifruoja paslaptis ramybės būsenoje ir įveda jas tik vykdymo metu.

Dažnos klaidos

  • Papildomos kabutės rakto reikšmėje: jei tavo kintamasis turi literalių kabučių, užklausos nepavyks dėl autentifikavimo klaidos
  • Kintamasis nustatytas kitame apvalkale: kintamieji iš vieno terminalo nėra prieinami kitame, nebent jie eksportuoti tavo profilyje
  • Tarpai aplink ženklą =: .env faile sintaksė XAI_API_KEY = value su tarpais gali neveikti, priklausomai nuo naudojamos bibliotekos

Svarbiausi punktai

  • Naudok XAI_API_KEY kintamąjį, kurį atpažįsta kiekvienas „xAI“ SDK
  • Niekada neįkoduojo rakto tiesiai į源代码
  • Įtrauk .env į visų savo projektų .gitignore
  • Gamyboje naudok savo talpinimo platformos integruotus paslapčių valdymo įrankius