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

Správa API: Správa kľúčov a fakturácie

Lekcia 12 z 14 Aktualizované 28. júla 2026 Mierne pokročilý
Na tejto strane
  1. Spravuj svoj účet bez konzoly
  2. Vytváranie a rotácia kľúčov
  3. Sledovanie a kontrola fakturácie
  4. Monitoruj svoju spotrebu na správnej úrovni granularity
  5. Kľúčové poznatky

Spravuj svoj účet bez konzoly

Správa API (Management API) od xAI je rozhranie REST určené na správu účtu tvojej podnikovej organizácie. Zatiaľ čo Inferenčné API (api.x.ai) volá modely, Správa API (management-api.x.ai) administruje tvoje zdroje. Tento rozdiel sa môže zdať nepodstatný. Nie je. Všetko, čo by inak vyžadovalo, aby niekto otvoril webovú konzolu a klikal, sa tu stáva automatizovateľným – sledovateľným, reprodukovateľným a integrovateľným s nástrojmi, ktoré tvoje tímy už používajú.

Vytváranie a rotácia kľúčov

Vytváranie kľúčov prostredníctvom API ti umožňuje automatizovať nasadenie pre novú aplikáciu alebo prostredie:

curl -X POST "https://management-api.x.ai/auth/teams/{teamId}/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "cle-production-chatbot",
    "acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
    "qps": 10,
    "qpm": 100,
    "tpm": 1000000,
    "expireTime": "2026-12-31T23:59:59Z"
  }'

Parametre v tejto požiadavke úplne definujú rozsah platnosti kľúča:

  • name: Čitateľný identifikátor pre kľúč
  • acls: Zoznam povolení (autorizované koncové body a modely)
  • qps/qpm/tpm: Limity rýchlosti za sekundu, za minútu a tokenov za minútu
  • expireTime: Dátum automatickej expirácie

Nastavenie expireTime pri vytváraní je zvyk, ktorý ti z dlhodobého hľadiska ušetrí najviac problémov: kľúč vydaný na trojmesačný pilotný projekt vyprší sám od seba, namiesto toho, aby neobmedzene prežíval v konfiguračnom súbore, ktorý už nikto nečíta.

Pravidelná rotácia kľúčov dodržiava rovnakú hygienu zabezpečenia. Vyhradený koncový bod vygeneruje nový tajný kľúč a zneplatní starý:

curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Upozornenie: starý tajný kľúč sa zneplatní okamžite a natrvalo. Pred spustením príkazu sa priprav na nasadenie novej hodnoty do svojho správcu tajných údajov, nikdy nie až afterward. Súbor uzatvárajú tri koncové body len na čítanie: GET /auth/teams/{teamId}/api-keys vypíše všetky kľúče pre tím, GET /auth/api-keys/{apiKeyId}/propagation overí, či je kľúč propagovaný vo všetkých uzloch, a GET /auth/teams/{teamId}/models vypíše dostupné modely s ich cenami. Druhý z nich je ten, ktorý konzultuješ ihneď po rotácii, keď aplikácia stále vracia chyby overenia a nie si si istý, či ide o chybu v aplikácii, alebo jednoducho o oneskorenie propagácie.

Sledovanie a kontrola fakturácie

Na získanie informácií o fakturácii sa používa vyhradený koncový bod:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Históriu faktúr získaš s filtrovaním podľa obdobia, tu pre marec 2026:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Každá faktúra má stav medzi hodnotami PENDING, PAID, FAILED a WILL_NEVER_BE_CHARGED. Zobrazenie stavu FAILED v tvojom monitoringu je oveľa lepšie, než sa o incidente dozvedieť až cez výpadok služby v pondelok ráno.

Aby si predišiel prekročeniu rozpočtu, nakonfiguruj mesačný limit:

curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 5000}'

Ak funguješ na báze predplatených služieb, skontroluj zostatok rovnakým spôsobom:

# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Pamätaj, že predplatené kredity sú nevratné, pokiaľ to nevyžaduje zákon. Veľkosť nákupov prispôsob spotrebe pozorovanej počas niekoľkých týždňov, nie optimistickým projekciám rastu.

Monitoruj svoju spotrebu na správnej úrovni granularity

Analytický koncový bod ti umožňuje sledovať využitie s jemnou granularitou:

curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/usage" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-03-01 00:00:00",
        "endTime": "2026-04-01 00:00:00",
        "timezone": "UTC"
      },
      "timeUnit": "DAY",
      "values": [{"name": "tokens", "aggregation": "SUM"}],
      "groupBy": ["model"]
    }
  }'

Táto požiadavka vráti dennú spotrebu tokenov rozdelenú podľa modelu za marec. Zmenou timeUnit prepneš z mesačného pohľadu na pohľad po minútach: možné hodnoty sú MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR a MINUTE. Agregácie idú ďaleko nad rámec jednoduchých súčtov a zahŕňajú SUM, AVG, MIN, MAX, P50, P90, P99 a COUNT. Percentily efektívne charakterizujú záťaž, pretože priemery vyhladzujú práve tie špičky, ktoré určujú kapacitu, ktorú skutočne potrebuješ.

Správa API si následne nájde svoje miesto v tvojom nástrojovom reťazci. Kľúče provisionuješ z Terraformu alebo Pulumi rovnako ako databázu, tvoj pipeline CI/CD vytvára ephemeral kľúče pre testovacie prostredia a na konci vykonávania ich maže, skripty monitoringu alertujú pred dosiahnutím limitu míňania a tvoje interné dashboardy zobrazujú spotrebu bez toho, aby musel človek každý pondelok exportovať CSV.

Kľúčové poznatky

  • Správa API na management-api.x.ai spravuje kľúče, fakturáciu a metriky
  • Rotácia kľúča natrvalo zneplatní starý tajný kľúč
  • Limity míňania chránia pred prekročením rozpočtu
  • Analytika využitia ponúka granularitu od minúty po mesiac
  • Integruj Správu API do svojich infraštruktúrnych nástrojov na automatizáciu administratívy