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

URL de bază și prima cerere

Lecția 1 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. API-ul de Management: Un Plan de Control Separat
  2. URL de bază
  3. Autentificarea la API-ul de Management
  4. Structura Endpoint-urilor
  5. Prima Dumneavoastră Cerere de Management
  6. Puncte cheie

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.

2
URL-uri distincte
REST
Arhitectură standard
JSON
Format de schimb
Bearer
Autentificare

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 de https://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/validation vă permite să testați configurația
  • Toate endpoint-urile de management sunt organizate în jurul teamId