Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Základná URL adresa a prvá požiadavka

Lekcia 1 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Manažérske API: Samostatná rovina riadenia
  2. Základná URL adresa
  3. Autentifikácia v Manažérskom API
  4. Štruktúra endpointov
  5. Tvoja prvá manažérska požiadavka
  6. Kľúčové poznatky

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.

2
Odlišné URL adresy
REST
Štandardná architektúra
JSON
Formát výmeny dát
Bearer
Autentifikácia

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é od https://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/validation umožňuje otestovať tvoju konfiguráciu
  • Všetky manažérske endpointy sú organizované okolo teamId