Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

XAI_API_KEY-ympäristömuuttuja

Oppitunti 3 / 14 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Säilytä avaimesi turvallisesti
  2. Aseta XAI_API_KEY
  3. Tarkista konfiguraatio
  4. Tuotantoympäristöt
  5. Yleiset virheet
  6. Keskeiset asiat

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 syntaksi XAI_API_KEY = value vä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ää .env kaikkien projektiesi .gitignore-tiedostoon
  • Käytä tuotannossa hosting-alustasi omia salaisuusmekanismeja