Management API: Zarządzanie kluczami i rozliczeniami
Na tej stronie
Zarządzaj swoim kontem bez użycia konsoli
Management API od xAI to interfejs REST dedykowany zarządzaniu kontem Enterprise. Podczas gdy Inference API (api.x.ai) wywołuje modele, Management API (management-api.x.ai) administruje Twoimi zasobami. Różnica może wydawać się niewielka. Nie jest. Wszystko, co w innym wypadku wymagałoby od kogoś otwarcia konsoli internetowej i klikania, tutaj staje się automatyzowalne – możliwe do śledzenia, odtwarzania i integracji z narzędziami, z których już korzystają Twoje zespoły.
Tworzenie i rotacja kluczy
Tworzenie kluczy przez API pozwala zautomatyzować aprowizację dla nowej aplikacji lub środowiska:
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 w tym żądaniu w pełni definiują zakres działania klucza:
- name: Czytelny dla człowieka identyfikator klucza
- acls: Lista uprawnień (autoryzowane punkty końcowe i modele)
- qps/qpm/tpm: Limity przepustowości: na sekundę, na minutę oraz tokenów na minutę
- expireTime: Data automatycznego wygaśnięcia
Ustawienie expireTime już przy tworzeniu to nawyk, który w dłuższej perspektywie przysporzy Ci najmniej problemów: klucz wydany na trzy miesiące testów wygasa samoczynnie, zamiast wiecznie tkwić w pliku konfiguracyjnym, którego już nikt nie czyta.
Regularna rotacja kluczy wynika z tych samych zasad higieny bezpieczeństwa. Dedykowany punkt końcowy generuje nowy klucz tajny i unieważnia stary:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Ostrzeżenie: stary klucz tajny zostaje unieważniony natychmiast i bezpowrotnie. Przygotuj wdrożenie nowej wartości w menedżerze sekretów przed uruchomieniem polecenia, nigdy po nim. Trzy punkty końcowe tylko do odczytu uzupełniają zestaw: GET /auth/teams/{teamId}/api-keys wyświetla listę wszystkich kluczy zespołu, GET /auth/api-keys/{apiKeyId}/propagation weryfikuje propagację klucza na wszystkich węzłach, a GET /auth/teams/{teamId}/models listuje dostępne modele wraz z ich cennikiem. Drugiego z nich używasz zaraz po rotacji, gdy aplikacja nadal zwraca błędy uwierzytelniania, a Ty nie wiesz, czy to błąd aplikacji, czy po prostu opóźnienie propagacji.
Śledzenie i kontrola rozliczeń
Pobieranie informacji o rozliczeniach odbywa się przez dedykowany punkt końcowy:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Historię faktur pobierasz z filtrowaniem według okresu, tutaj dla marca 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Każda faktura ma status spośród: PENDING, PAID, FAILED oraz WILL_NEVER_BE_CHARGED. Wykrycie statusu FAILED w monitoringu jest znacznie lepsze niż dowiedzenie się o incydencie przez przerwy w działaniu usługi w poniedziałek rano.
Aby zapobiec przekroczeniu budżetu, skonfiguruj miesięczny 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}'
Jeśli działasz w modelu prepaid, saldo sprawdzasz w ten sam sposób:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Pamiętaj, że kredyty prepaid są bezzwrotne, chyba że prawo stanowi inaczej. Dobieraj wielkość zakupów na podstawie zużycia obserwowanego przez kilka tygodni, a nie optymistycznych prognoz wzrostu.
Monitoruj zużycie z odpowiednią granulacją
Punkt końcowy analityki pozwala śledzić użycie z dużą dokładnością:
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"]
}
}'
To żądanie zwraca dzienne zużycie tokenów z podziałem na modele dla marca. Zmieniając timeUnit, przechodzisz z widoku miesięcznego na widok minutowy: dostępne wartości to MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR i MINUTE. Agregacje wykraczają daleko poza proste sumy, obejmując SUM, AVG, MIN, MAX, P50, P90, P99 oraz COUNT. Percentyle skutecznie charakteryzują obciążenie, ponieważ średnie wygładzają właśnie te skoki, które decydują o faktycznie potrzebnej pojemności.
Management API zajmuje wtedy swoje miejsce w Twoim łańcuchu narzędzi. Klucze aprowizujesz z poziomu Terraform lub Pulumi tak jak bazę danych, potok CI/CD tworzy klucze efemeryczne dla środowisk testowych i usuwa je po zakończeniu wykonania, skrypty monitoringu alarmują przed osiągnięciem limitu wydatków, a wewnętrzne dashboardy wyświetlają zużycie bez konieczności ręcznego eksportowania CSV w każdy poniedziałek.
Kluczowe wnioski
- Management API na management-api.x.ai obsługuje klucze, rozliczenia i metryki
- Rotacja klucza trwale unieważnia stary klucz tajny
- Limity wydatków chronią przed przekroczeniem budżetu
- Analityka zużycia oferuje granulację od minuty do miesiąca
- Zintegruj Management API ze swoimi narzędziami infrastrukturalnymi, aby zautomatyzować administrację