URL de bază și prima cerere
Pe această pagină
API-ul de Management: Un Plan de Control Separat
API-ul de Management al xAI este distinct de API-ul de inferență pe care îl utilizați pentru a trimite prompturi către Grok. Acesta vă permite să administrați resursele: creați și gestionați chei API, configurați facturile, monitorizați utilizarea și controlați accesul echipei dumneavoastră. Toată această administrare se realizează printr-un URL dedicat.
URL de bază
Această separare nu este un detaliu de implementare: ea reflectă o diferență fundamentală între cele două API-uri. Unul consumă tokeni și rulează modele; celălalt administrează, facturează și acordă permisiuni. Menținerea lor pe două domenii și cu două seturi de chei garantează că o cheie de aplicație furată nu poate crea niciodată alte chei sau citi informațiile dumneavoastră de facturare.
https://management-api.x.ai
Nu confundați acest URL cu https://api.x.ai, care este adresa pentru apelurile de inferență (completări chat, embedding-uri etc.). Toate cererile de management—chei, facturare, analitice—trec prin management-api.x.ai.
Autentificarea la API-ul de Management
Mecanismul de autentificare este identic—un token Bearer în antetul Authorization—dar cheia în sine nu este aceeași. Aceasta este cea mai frecventă sursă de confuzie la început și produce o eroare 401 perfect opacă: nimic în mesajul de eroare nu indică faptul că ați prezentat pur și simplu cheia corectă API-ului greșit.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Această cerere de validare (GET /auth/management-keys/validation) vă permite să verificați dacă cheia dumneavoastră de management este validă și activă. Este cel mai simplu punct de intrare pentru a testa configurația.
Cheie de Management vs. Cheie de Inferență
- Cheie de management: acordă acces la endpoint-urile
management-api.x.ai(administrare, facturare, analitice) - Cheie de inferență: acordă acces la endpoint-urile
api.x.ai(chat, embedding-uri, imagini)
Ambele tipuri de chei sunt generate din consola xAI, dar domeniile lor de aplicare diferă. O cheie de inferență nu poate accesa endpoint-urile de management și viceversa.
Structura Endpoint-urilor
Endpoint-urile API-ului de Management urmează o organizare logică:
/auth/teams/{teamId}/api-keys— gestionarea cheilor API/auth/api-keys/{apiKeyId}— operațiuni asupra unei chei specifice/auth/teams/{teamId}/models— modele accesibile/auth/teams/{teamId}/endpoints— endpoint-urile ACL disponibile/v1/billing/teams/{teamId}/— facturare și analitice
Parametrul teamId este identificatorul echipei dumneavoastră în consola xAI și structurează aproape toate endpoint-urile. Fiecare echipă are propriile chei, cote și setări de facturare—ceea ce o face unitatea naturală de izolare: separarea a două proiecte în două echipe separă, de asemenea, bugetele și accesul acestora, fără nicio configurație suplimentară.
Prima Dumneavoastră Cerere de Management
Iată un exemplu complet pentru a valida configurația:
# Definiți cheia de management
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Validați cheia
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Dacă răspunsul conține informații despre echipa și cheia dumneavoastră, configurația funcționează. Dacă primiți o eroare 401, verificați dacă utilizați o cheie de management (nu o cheie de inferență).
Puncte cheie
- API-ul de Management utilizează
https://management-api.x.ai, distinct dehttps://api.x.ai - Autentificarea folosește un token Bearer în antetul
Authorization - Cheile de management și cheile de inferență au domenii de aplicare separate
- Endpoint-ul
GET /auth/management-keys/validationvă permite să testați configurația - Toate endpoint-urile de management sunt organizate în jurul
teamId