Variabila de mediu XAI_API_KEY
Pe această pagină
Stocați-vă cheia în siguranță
O cheie API nu trebuie să apară niciodată sub formă de text simplu în codul sursă. Abordarea standard constă în stocarea acesteia într-o variabilă de mediu pe care aplicația dumneavoastră o citește la pornire. Aceasta separă configurația de cod și vă protejează datele secrete.
Setarea variabilei XAI_API_KEY
Convenția utilizată de xAI și de toate SDK-urile oficiale este variabila XAI_API_KEY. Iată cum să o setați pe sistemul dumneavoastră.
Linux și macOS
În terminal, adăugați variabila în profilul shell-ului:
echo 'export XAI_API_KEY="xai-your-key-here"' >> ~/.bashrc
source ~/.bashrc
Pentru Zsh (implicit pe macOS), înlocuiți .bashrc cu .zshrc.
Windows (PowerShell)
$env:XAI_API_KEY = "xai-your-key-here"
Pentru a o face permanentă, utilizați variabilele de mediu ale sistemului prin setările avansate sau rulați:
[System.Environment]::SetEnvironmentVariable("XAI_API_KEY", "xai-your-key-here", "User")
Fișier .env (proiecte locale)
Pentru proiectele care utilizează un framework (Node.js, Django, Flask), creați un fișier .env în rădăcina proiectului:
XAI_API_KEY=xai-your-key-here
Trebuie să adăugați .env în fișierul dumneavoastră .gitignore pentru a nu împinge datele secrete într-un depozit Git:
# .gitignore
.env
.env.local
.env.*.local
Verificarea configurației
Testați dacă variabila este disponibilă:
echo $XAI_API_KEY
Ar trebui să vedeți cheia. Dacă comanda returnează o linie goală, reîncărcați profilul shell-ului sau reporniți terminalul.
În Python, o puteți verifica astfel:
import os
key = os.getenv("XAI_API_KEY")
print("Key configured" if key else "Variable missing")
Medii de producție
În producție, nu utilizați un fișier .env. Folosiți în schimb mecanismele integrate ale platformei dumneavoastră:
- Docker:
docker run -e XAI_API_KEY=xai-xxx my-image - Kubernetes: un Secret montat ca variabilă de mediu
- Vercel / Netlify / Railway: variabile în tabloul de bord al proiectului
- GitHub Actions: secretele depozitului (
${{ secrets.XAI_API_KEY }})
Aceste sisteme criptează secretele în repaus și le injectează doar la momentul execuției.
Erori frecvente
- Ghilimele suplimentare în cheie: dacă variabila conține ghilimele literale, cererile vor eșua cu o eroare de autentificare
- Variabilă setată într-un alt shell: variabilele dintr-un terminal nu sunt disponibile în altul decât dacă sunt exportate în profilul dumneavoastră
- Spații în jurul semnului
=: într-un fișier.env, sintaxaXAI_API_KEY = valuecu spații poate eșua în funcție de biblioteca pe care o utilizați
Puncte cheie
- Utilizați variabila
XAI_API_KEY, recunoscută de fiecare SDK xAI - Nu încorporați niciodată cheia direct în codul sursă
- Adăugați
.envîn.gitignorepentru toate proiectele dumneavoastră - În producție, utilizați mecanismele de secrete integrate ale platformei de găzduire