XAI_API_KEY-ympäristömuuttuja
Tällä sivulla
Säilytä avaimesi turvallisesti
API-avainta ei saa koskaan esiintyä lähdekoodissasi selväkielisenä tekstinä. Standarditapa on tallentaa se ympäristömuuttujaan, jonka sovelluksesi lukee käynnistyksen yhteydessä. Tämä erottaa konfiguraation koodista ja suojaa salaisuutesi.
Aseta XAI_API_KEY
xAI:n ja kaikkien virallisten SDK:iden käyttämä käytäntö on muuttuja XAI_API_KEY. Näin asetat sen järjestelmääsi.
Linux ja macOS
Lisää muuttuja komentotulkin profiiliisi terminaalissa:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Jos käytät Zsh:ää (oletus macOS:ssä), korvaa .bashrc tiedostolla .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Tehdäksesi muutoksen pysyväksi, käytä järjestelmän ympäristömuuttujia Lisäasetusten kautta tai suorita:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
.env-tiedosto (paikalliset projektit)
Projekteissa, jotka käyttävät kehystä (Node.js, Django, Flask), luo .env-tiedosto projektin juureen:
XAI_API_KEY=xai-your-key-here
Sinun täytyy lisätä .env tiedostoosi .gitignore, ettet vahingossa työnnä salaisuuksiasi Git-varastoon:
# .gitignore
.env
.env.local
.env.*.local
Tarkista konfiguraatio
Testaa, onko muuttuja saatavilla:
echo $XAI_API_KEY
Sinun pitäisi nähdä avaimesi. Jos komento palauttaa tyhjän rivin, lataa komentotulkin profiili uudelleen tai käynnistä terminaali uudelleen.
Pythonissa voit tarkistaa sen näin:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Tuotantoympäristöt
Älä käytä .env-tiedostoa tuotannossa. Käytä sen sijaan alustasi omia mekanismeja:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: Secret, joka on liitetty ympäristömuuttujana
- Vercel / Netlify / Railway: muuttujat projektin hallintapaneelissa
- GitHub Actions: varaston salaisuudet (
${{ secrets.XAI_API_KEY }})
Nämä järjestelmät salaavat salaisuudet levossa ja syöttävät ne vain ajon aikana.
Yleiset virheet
- Lainausmerkit avaimessa: jos muuttujasi sisältää kirjaimellisia lainausmerkkejä, pyynnöt epäonnistuvat todennusvirheellä
- Muuttuja asetettu toisessa kuoressa: yhden terminaalin muuttujat eivät ole saatavilla toisessa, ellei niitä ole viety profiiliisi
- Välilyönnit merkin
=ympärillä:.env-tiedostossa syntaksiXAI_API_KEY = valuevälilyönnein voi epäonnistua käyttämästäsi kirjastosta riippuen
Keskeiset asiat
- Käytä muuttujaa
XAI_API_KEY, jonka jokainen xAI SDK tunnistaa - Älä koskaan kovakoodaa avainta lähdekoodiisi
- Lisää
.envkaikkien projektiesi.gitignore-tiedostoon - Käytä tuotannossa hosting-alustasi omia salaisuusmekanismeja