Salt la conținutul principal
Română— Alege o limbă
Meniu

Variabila de mediu XAI_API_KEY

Lecția 3 din 14 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Stocați-vă cheia în siguranță
  2. Setarea variabilei XAI_API_KEY
  3. Verificarea configurației
  4. Medii de producție
  5. Erori frecvente
  6. Puncte cheie

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, sintaxa XAI_API_KEY = value cu 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 .gitignore pentru toate proiectele dumneavoastră
  • În producție, utilizați mecanismele de secrete integrate ale platformei de găzduire