Základná URL adresa a prvá požiadavka
Na tejto strane
Manažérske API: Samostatná rovina riadenia
Manažérske API od xAI je oddelené od inferenčného API, ktoré používaš na odosielanie promptov modelu Grok. Umožňuje ti spravovať tvoje zdroje: vytvárať a spravovať API kľúče, konfigurovať fakturáciu, monitorovať využitie a kontrolovať prístup tvojho tímu. Celá táto administrácia prebieha cez vyhradenú URL adresu.
Základná URL adresa
Toto oddelenie nie je len implementačný detail: odráža zásadný rozdiel medzi týmito dvoma API. Jedno spotrebúva tokeny a spúšťa modely; druhé spravuje, fakturuje a udeľuje oprávnenia. Ich udržanie na dvoch rôznych doménach a s dvoma sadami kľúčov garantuje, že ukradnutý aplikačný kľúč nikdy nemôže vytvoriť ďalšie kľúče ani čítať tvoje fakturačné údaje.
https://management-api.x.ai
Nezamieňaj túto adresu s https://api.x.ai, čo je URL pre inferenčné volania (dokončovanie chatu, vektory embeddings atď.). Všetky manažérske požiadavky – kľúče, fakturácia, analytika – prechádzajú cez management-api.x.ai.
Autentifikácia v Manažérskom API
Mechanizmus autentifikácie je totožný – Bearer token v hlavičke Authorization – ale samotný kľúč nie. Toto je najčastejšia chyba pri začiatkoch a výsledkom je úplne nezrozumiteľná chyba 401: v chybovej správe nič nenaznačuje, že si jednoducho predložil správny kľúč nesprávnemu API.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Táto validačná požiadavka (GET /auth/management-keys/validation) ti umožňuje overiť, či je tvoj manažérsky kľúč platný a aktívny. Je to najjednoduchší vstupný bod na otestovanie tvojej konfigurácie.
Manažérsky kľúč vs. Inferenčný kľúč
- Manažérsky kľúč: udeľuje prístup k endpointom
management-api.x.ai(administrácia, fakturácia, analytika) - Inferenčný kľúč: udeľuje prístup k endpointom
api.x.ai(chat, embeddings, obrázky)
Oba typy kľúčov sa generujú v konzole xAI, ale ich rozsahy (scopes) sa líšia. Inferenčný kľúč nemôže pristupovať k manažérskym endpointom a naopak.
Štruktúra endpointov
Endpointy Manažérskeho API nasledujú logickú organizáciu:
/auth/teams/{teamId}/api-keys— správa API kľúčov/auth/api-keys/{apiKeyId}— operácie na konkrétnom kľúči/auth/teams/{teamId}/models— dostupné modely/auth/teams/{teamId}/endpoints— dostupné ACL endpointy/v1/billing/teams/{teamId}/— fakturácia a analytika
Parameter teamId je identifikátorom tvojho tímu v konzole xAI a štruktúruje takmer všetky endpointy. Každý tím má svoje vlastné kľúče, kvóty a nastavenia fakturácie – čo z neho robí prirodzenú jednotku izolácie: rozdelenie dvoch projektov do dvoch tímov zároveň oddelí ich rozpočty a prístupy bez akejkoľvek ďalšej konfigurácie.
Tvoja prvá manažérska požiadavka
Tu je kompletný príklad na validáciu tvojej konfigurácie:
# Definuj svoj manažérsky kľúč
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Validuj kľúč
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Ak odpoveď obsahuje informácie o tvojom tíme a kľúči, tvoja konfigurácia funguje. Ak dostaneš chybu 401, over, či používaš manažérsky kľúč (nie inferenčný).
Kľúčové poznatky
- Manažérske API používa
https://management-api.x.ai, čo je odlišné odhttps://api.x.ai - Autentifikácia využíva Bearer token v hlavičke
Authorization - Manažérske kľúče a inferenčné kľúče majú oddelené rozsahy
- Endpoint
GET /auth/management-keys/validationumožňuje otestovať tvoju konfiguráciu - Všetky manažérske endpointy sú organizované okolo
teamId