Varijabla okruženja XAI_API_KEY
Na ovoj stranici
Sigurno pohrani svoj ključ
API ključ nikada ne smije biti vidljiv u izvornom kodu kao običan tekst. Standardni pristup je pohraniti ga u varijablu okruženja koju tvoja aplikacija čita pri pokretanju. Time odvajaš konfiguraciju od koda i štitiš svoje tajne.
Postavi XAI_API_KEY
Konvencija koju koriste xAI i svi službeni SDK-ovi je varijabla XAI_API_KEY. Evo kako je postaviti na svom sustavu.
Linux i macOS
U svom terminalu dodaj varijablu u profil svoje ljuske:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Za Zsh (zadano na macOS-u), zamijeni .bashrc s .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Da bi postavka bila trajna, upotrijebi sistemske varijable okruženja putem Naprednih postavki ili pokreni:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
.env datoteka (lokalni projekti)
Za projekte koji koriste framework (Node.js, Django, Flask), stvori .env datoteku u korijenskom direktoriju:
XAI_API_KEY=xai-your-key-here
Moraš dodati .env u svoju .gitignore datoteku kako ne bi slučajno poslao svoje tajne u Git repozitorij:
# .gitignore
.env
.env.local
.env.*.local
Provjeri konfiguraciju
Testiraj je li varijabla dostupna:
echo $XAI_API_KEY
Trebao bi vidjeti svoj ključ. Ako naredba vrati prazan redak, ponovno učitaj profil ljuske ili ponovno pokreni terminal.
U Pythonu to možeš provjeriti ovako:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Produkcijska okruženja
U produkciji nemoj koristiti .env datoteku. Umjesto toga upotrijebi ugrađene mehanizme svoje platforme:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: Tajna (Secret) montirana kao varijabla okruženja
- Vercel / Netlify / Railway: varijable na nadzornoj ploči projekta
- GitHub Actions: tajne repozitorija (
${{ secrets.XAI_API_KEY }})
Ovi sustavi šifriraju tajne u mirovanju i ubacuju ih isključivo tijekom izvršavanja.
Uobičajene pogreške
- Dodatni navodnici u ključu: ako tvoja varijabla sadrži doslovne navodnike, zahtjevi će neuspjeti s pogreškom autentifikacije
- Varijabla postavljena u drugoj ljusci: varijable iz jednog terminala nisu dostupne u drugom osim ako nisu izvezene u tvom profilu
- Razmaci oko znaka
=: u.envdatoteci, sintaksaXAI_API_KEY = vrijednosts razmacima može ne uspjeti, ovisno o biblioteci koju koristiš
Ključne točke
- Koristi varijablu
XAI_API_KEY, koju prepoznaje svaki xAI SDK - Nikada nemoj hardkodirati ključ u svom izvornom kodu
- Dodaj
.envu.gitignoresvih svojih projekata - U produkciji koristi ugrađene tajne svoje hosting platforme