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

Generarea unei chei API

Lecția 2 din 14 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Acces programatic la Grok
  2. Deschiderea consolei
  3. Crearea primei chei
  4. Cele mai bune practici de gestionare
  5. Facturare asociată cheilor
  6. Testarea imediată a cheii
  7. Puncte cheie

Acces programatic la Grok

Cheie API creată în consola xAI Cheia API este tokenul de autentificare care permite aplicațiilor dumneavoastră să comunice cu modelele Grok. Fără aceasta, nicio solicitare nu este procesată. Această lecție vă ghidează pas cu pas prin crearea și gestionarea cheilor în consola xAI.

Deschiderea consolei

Accesați console.x.ai și autentificați-vă cu contul creat în pasul anterior. Consola reprezintă tabloul de bord central pentru gestionarea cheilor, monitorizarea utilizării și configurarea facturilor.

În meniul lateral, deschideți secțiunea API Keys (calea completă: console.x.ai/team/default/api-keys).

Crearea primei chei

Faceți clic pe Create API Key. Puteți atribui fiecărei chei un nume descriptiv pentru a identifica scopul acesteia:

  • dev-local pentru mediul de dezvoltare
  • prod-backend pentru serverul de producție
  • test-ci pentru pipeline-ul de integrare continuă

Cheia este afișată o singură dată, imediat după creare. Copiați-o instantaneu și stocați-o într-un loc sigur (un manager de parole sau un seif de secrete). Dacă pierdeți o cheie, va trebui să generați una nouă.

Formatul cheii

Cheile API xAI încep cu prefixul xai-, urmat de un șir alfanumeric. Acest prefix vă ajută să le identificați rapid în fișierele de configurare și să le detectați dacă sunt expuse accidental în codul sursă.

Cele mai bune practici de gestionare

O cheie per mediu

Creați chei separate pentru fiecare context. Dacă o cheie este compromisă, o puteți revoca fără a afecta celelalte medii.

Rotire periodică

Reînnoiți cheile periodic, în special pentru mediile de producție. Procedura este simplă: creați o cheie nouă, actualizați aplicația, apoi ștergeți-o pe cea veche.

Verificare înainte de partajare

Înainte de a partaja un proiect, asigurați-vă că nicio cheie nu este codificată direct (hard-coded) în sursă. Utilizați fișiere .env excluse din controlul versiunilor (adăugați .env în fișierul .gitignore).

Facturare asociată cheilor

Fiecare apel API efectuat cu o cheie este contabilizat și facturat. xAI oferă două moduri:

  • Credite preplătite: cumpărați credite în avans, iar apelurile sunt deduse imediat
  • Facturare lunară: utilizarea care depășește creditele este facturat la sfârșitul lunii

Verificați informațiile de facturare în consolă înainte de a începe utilizarea API-ului, deoarece facturile nu pot fi modificate retroactiv.

Testarea imediată a cheii

Acordați-vă treizeci de secunde pentru a valida cheia înainte de a o integra într-un proiect. Cel mai simplu test solicită lista modelelor:

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer xai-your-key"

Un răspuns JSON care listează modelele confirmă faptul că cheia este activă și că facturarea este corectă. O eroare 401 indică o copiere incorectă a cheii; o eroare 403 semnalează o problemă de permisiuni sau de credite. Diagnosticarea problemei aici, la sursă, vă scutește de o sesiune de depanare ulterioară în mijlocul codului aplicației.

Puncte cheie

  • Creați cheile la adresa console.x.ai/team/default/api-keys
  • Acestea încep cu xai- și sunt afișate o singură dată
  • Creați câte o cheie per mediu și stocați-le într-un seif de secrete
  • Verificați modul de facturare înainte de orice apel API
  • Validați fiecare cheie nouă printr-un apel către /v1/models înainte de integrare