Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Keskkonnamuutuja XAI_API_KEY

Õppetund 3 / 14 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Salvesta oma võti turvaliselt
  2. Määra XAI_API_KEY
  3. Kontrolli konfiguratsiooni
  4. Tootmiskeskkonnad
  5. Levinud vead
  6. Peamised punktid

Salvesta oma võti turvaliselt

API-võti ei tohi kunagi ilmuda lähtekoodi puhtal tekstil. Standardne lähenemine on salvestada see keskkonnamuutujasse, mida sinu rakendus loeb käivitamisel. See eraldab konfiguratsiooni koodist ja kaitseb sinu salajasi andmeid.

Määra XAI_API_KEY

xAI ja kõik ametlikud SDK-d kasutavad muutujat XAI_API_KEY. Siin on juhised, kuidas see oma süsteemis seadistada.

Linux ja macOS

Lisa muutuja oma terminalis shelli profiili:

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

Zsh-i puhul (vaikimisi macOS-is) asenda .bashrc failiga .zshrc.

Windows (PowerShell)

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

Püsivaks muutmiseks kasuta süsteemi keskkonnamuutujaid täpsemate seadete kaudu või käivita:

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

.env-fail (kohalikud projektid)

Projektide jaoks, mis kasutavad raamistikku (Node.js, Django, Flask), loo juurkausta .env-fail:

XAI_API_KEY=xai-your-key-here

Sa pead lisama .env oma .gitignore-faili, et mitte laadida oma saladusi Git-hoidlasse:

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

Kontrolli konfiguratsiooni

Testi, kas muutuja on kättesaadav:

echo $XAI_API_KEY

Sa peaksid nägema oma võtit. Kui käsk tagastab tühja rea, laadi oma shelli profiil uuesti või taaskäivita terminal.

Pythonis saad seda kontrollida nii:

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

Tootmiskeskkonnad

Tootmises ära kasuta .env-faili. Kasuta selle asemel oma platvormi sisseehitatud mehhanisme:

  • Docker: docker run -e XAI_API_KEY=xai-xxx my-image
  • Kubernetes: Saladus (Secret), mis on haagitud keskkonnamuutujana
  • Vercel / Netlify / Railway: muutujad projekti armatuurlaual
  • GitHub Actions: hoidla saladused (${{ secrets.XAI_API_KEY }})

Need süsteemid krüpteerivad saladused puhkeolekus ja sisestavad need ainult käitusajal.

Levinud vead

  • Liigsed jutumärgid võtmes: kui sinu muutuja sisaldab sõnasõnalisi jutumärke, ebaõnnestuvad päringud autentimisveaga
  • Muutuja määratud teises shellis: ühest terminalist pärit muutujad ei ole teises saadaval, kui need pole sinu profiilis eksporditud
  • Tühikud märgi = ümber: .env-failis võib süntaks XAI_API_KEY = väärtus koos tühikutega ebaõnnestuda, sõltuvalt kasutatavast teegist

Peamised punktid

  • Kasuta muutujat XAI_API_KEY, mida tunneb ära iga xAI SDK
  • Ära kunagi kodeeri võtit otse oma lähtekoodi
  • Lisa .env kõigi oma projektide .gitignore-faili
  • Kasuta tootmises oma majutusplatvormi sisseehitatud saladuste haldust