Management API: atslēgu un rēķinu pārvaldība
Šajā lapā
Pārvaldi savu kontu bez konsoles
xAI Management API ir REST saskarne, kas paredzēta tava uzņēmuma konta pārvaldībai. Kamēr Inference API (api.x.ai) izsauc modeļus, Management API (management-api.x.ai) administrē tavus resursus. Šī atšķirība var šķist niecīga. Tā nav. Viss, kas citādi prasītu, lai kāds atvērtu tīmekļa konsoli un noklikšķinātu, šeit kļūst automatizējams — izsekojams, atkārtojams un integrējams ar rīkiem, ko tavas komandas jau izmanto.
Atslēgu izveide un rotācija
Atslēgu izveide, izmantojot API, ļauj automatizēt nodrošināšanu jaunai lietotnei vai videi:
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"
}'
Šī pieprasījuma parametri pilnībā definē atslēgas darbības jomu:
- name: Cilvēkam lasāms atslēgas identifikators
- acls: Atļauju saraksts (autorizētie galapunkti un modeļi)
- qps/qpm/tpm: Ātruma ierobežojumi sekundē, minūtē un tokeni minūtē
- expireTime: Automātisks derīguma termiņš
Parametra expireTime iestatīšana izveides brīdī ir ieradums, kas ilgtermiņā saglabā tev visvairāk nepatikšanu: atslēga, kas izdota trīs mēnešu izmēģinājuma projektam, beidz pati savu darbību, nevis paliek uz nenoteiktu laiku konfigurācijas failā, ko neviens vairs nelasa.
Regulāra atslēgu rotācija ievēro tos pašus drošības higiēnas principus. Speciālais galapunkts ģenerē jaunu slepeno atslēgu un atzīst veco par nederīgu:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Brīdinājums: vecā slepenā atslēga tiek atzīta par nederīgu nekavējoties un neatgriezeniski. Sagatavojies jaunās vērtības izvēršanai savā noslēpumu pārvaldniekā pirms komandas izpildes, nevis pēc tam. Trīs tikai lasāmi galapunkti papildina kopu: GET /auth/teams/{teamId}/api-keys uzskaita visas komandas atslēgas, GET /auth/api-keys/{apiKeyId}/propagation pārbauda, vai atslēga ir replicēta visos mezglos, un GET /auth/teams/{teamId}/models uzskaita pieejamos modeļus ar to cenām. Otro tu konsultē tūlīt pēc rotācijas, kad lietotne joprojām atgriež autentifikācijas kļūdas un tu neesi pārliecināts, vai tā ir lietotnes kļūda vai vienkārši replicēšanas aizkave.
Izseko un kontrolē rēķinus
Rēķinu informācijas iegūšanai tiek izmantots speciāls galapunkts:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Tu vari iegūt rēķinu vēsturi ar perioda filtrēšanu, šeit 2026. gada martam:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Katram rēķinam ir statuss: PENDING, PAID, FAILED vai WILL_NEVER_BE_CHARGED. Statusa FAILED parādīšanās tavā uzraudzībā ir daudz labāka nekā iepazīšanās ar incidentu, piedzīvojot pakalpojuma pārtraukumu pirmdienas rītā.
Lai novērstu budžeta pārsniegšanu, konfigurē mēneša limitu:
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}'
Ja strādā ar priekšapmaksu, pārbaudi atlikumu tāpat:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Atceries, ka priekšapmaksas kredīti ir neatgriezeniski, ja vien tas nav likumiski noteikts. Plāno savus pirkumus, balstoties uz patēriņu, kas novērots vairāku nedēļu garumā, nevis uz optimistiskām izaugsmes prognozēm.
Uzraugi savu patēriņu pareizā granularitātē
Analītikas galapunkts ļauj izsekot lietojumam ar smalku granularitāti:
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"]
}
}'
Šis pieprasījums atgriež ikdienas tokena patēriņu, sadalītu pa modeļiem, martam. Mainot timeUnit, tu vari pāriet no mēneša skata uz skatu pa minūtēm: iespējamās vērtības ir MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR un MINUTE. Agregācijas sniedzas tālu aiz vienkāršām summām, ietverot SUM, AVG, MIN, MAX, P50, P90, P99 un COUNT. Percentiles efektīvi raksturo slodzi, jo vidējie rādītāji izlīdzina tieši tos pīķus, kas nosaka tev faktiski nepieciešamo jaudu.
Tad Management API ieņem savu vietu tavā rīku ķēdē. Tu nodrošini atslēgas no Terraform vai Pulumi tāpat kā datubāzi, tava CI/CD cauruļvads izveido īslaicīgas atslēgas testa vidēm un dzēš tās izpildes beigās, uzraudzības skripti brīdina pirms izdevumu limita sasniegšanas, un tavi iekšējie informācijas paneļi attēlo patēriņu, nevienam cilvēkam katru pirmdienu neeksportējot CSV failu.
Galvenās atziņas
- Management API vietnē management-api.x.ai pārvalda atslēgas, rēķinus un metrikas
- Atslēgu rotācija neatgriezeniski atzīst veco slepeno atslēgu par nederīgu
- Izdevumu limiti pasargā no budžeta pārsniegšanas
- Lietojuma analītika piedāvā granularitāti no minūtes līdz mēnesim
- Integrē Management API savos infrastruktūras rīkos, lai automatizētu administrēšanu