Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Management API: Správa klíčů a fakturace

Lekce 12 z 14 Aktualizováno 28. července 2026 Mírně pokročilý
Na této stránce
  1. Spravuj svůj účet bez konzole
  2. Vytváření a rotace klíčů
  3. Sledování a kontrola fakturace
  4. Monitoruj svou spotřebu ve správné granularitě
  5. Klíčové poznatky

Spravuj svůj účet bez konzole

Management API od xAI je REST rozhraní určené výhradně ke správě tvého podnikového účtu. Zatímco Inference API (api.x.ai) volá modely, Management API (management-api.x.ai) administruje tvé zdroje. Tento rozdíl se může zdát nepodstatný. Není. Vše, co by jinak vyžadovalo, aby někdo otevřel webovou konzoli a klikal, se zde stává automatizovatelným – sledovatelným, reprodukovatelným a integrovatelným s nástroji, které tvé týmy již používají.

Vytváření a rotace klíčů

Vytváření klíčů prostřednictvím API ti umožňuje automatizovat nasazení pro novou aplikaci nebo prostředí:

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"
  }'

Parametry v tomto požadavku plně definují rozsah klíče:

  • name: Čitelný identifikátor klíče pro člověka
  • acls: Seznam oprávnění (autorizované endpointy a modely)
  • qps/qpm/tpm: Limity rychlosti na sekundu, na minutu a tokenů za minutu
  • expireTime: Datum automatického vypršení platnosti

Nastavení expireTime při vytváření je zvyk, který ti dlouhodobě ušetří nejvíce problémů: klíč vydaný na tříměsíční pilotní provoz sám vyprší, místo aby neomezeně přežíval v konfiguračním souboru, který už nikdo nečte.

Pravidelná rotace klíčů dodržuje stejnou bezpečnostní hygienu. Vyhrazený endpoint vygeneruje nový tajný klíč a zneplatní ten starý:

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

Upozornění: starý tajný klíč je zneplatněn okamžitě a trvale. Připrav si nasazení nové hodnoty do svého správce tajných údajů před spuštěním příkazu, nikdy až po něm. Sadu doplňují tři endpointy pouze pro čtení: GET /auth/teams/{teamId}/api-keys vypíše všechny klíče pro tým, GET /auth/api-keys/{apiKeyId}/propagation ověří, zda je klíč propagován na všechny uzly, a GET /auth/teams/{teamId}/models vypíše dostupné modely s jejich cenami. Druhý z nich konzultuješ hned po rotaci, když aplikace stále vrací chyby ověření a nejsi si jistý, zda jde o chybu v aplikaci, nebo pouze o zpoždění propagace.

Sledování a kontrola fakturace

Načítání informací o fakturaci využívá vyhrazený endpoint:

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

Historii faktur získáš s filtrováním podle období, zde pro březen 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á faktura má stav mezi PENDING, PAID, FAILED a WILL_NEVER_BE_CHARGED. Odhalení stavu FAILED v tvém monitoringu je mnohem lepší, než se o incidentu dozvědět prostřednictvím výpadku služby v pondělí ráno.

Aby sis předešel překročení rozpočtu, nakonfiguruj měsíční strop:

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}'

Pokud funguješ na bázi předplatného (prepaid), zkontroluj zůstatek stejným způsobem:

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

Pamatuj, že prepaid kredity jsou nevratné, pokud to nevyžaduje zákon. Velikost nákupů přizpůsob spotřebě pozorované během několika týdnů, nikoliv optimistickým prognózám růstu.

Monitoruj svou spotřebu ve správné granularitě

Analytics endpoint ti umožňuje sledovat využití 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"]
    }
  }'

Tento požadavek vrátí denní spotřebu tokenů rozdělenou podle modelu za březen. Změnou timeUnit přepneš z měsíčního pohledu na pohled po minutách: možné hodnoty jsou MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR a MINUTE. Agregace sahají daleko za prosté součty, včetně SUM, AVG, MIN, MAX, P50, P90, P99 a COUNT. Percentily účinně charakterizují zátěž, protože průměry vyhlazují právě ty špičky, které určují kapacitu, kterou skutečně potřebuješ.

Management API si pak najde své místo ve tvém nástrojovém řetězci. Klíče nasazuješ z Terraformu nebo Pulumi stejně jako databázi, tvůj CI/CD pipeline vytváří efemérní klíče pro testovací prostředí a na konci běhu je maže, skripty pro monitoring upozorní před dosažením stropu útrat a tvé interní dashboardy zobrazují spotřebu bez toho, aby někdo každé pondělí exportoval CSV.

Klíčové poznatky

  • Management API na management-api.x.ai spravuje klíče, fakturaci a metriky
  • Rotace klíče trvale zneplatní starý tajný klíč
  • Limity útrat chrání před překročením rozpočtu
  • Analytika využití nabízí granularitu od minuty po měsíc
  • Integruj Management API do svých infrastrukturních nástrojů pro automatizaci správy