Keskkonnamuutuja XAI_API_KEY
Sellel lehel
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üntaksXAI_API_KEY = väärtuskoos 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
.envkõigi oma projektide.gitignore-faili - Kasuta tootmises oma majutusplatvormi sisseehitatud saladuste haldust