Generarea unei chei API
Pe această pagină
Acces programatic la Grok
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-localpentru mediul de dezvoltareprod-backendpentru serverul de producțietest-cipentru 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