Management API: raktų ir sąskaitų faktūrų valdymas
Šiame puslapyje
Valdyk savo paskyrą be konsolės
„xAI Management API“ yra REST sąsaja, skirta valdyti tavo įmonės paskyrą. Jei „Inference API“ (api.x.ai) kviečia modelius, tai „Management API“ (management-api.x.ai) administruoja tavo išteklius. Šis skirtumas gali atrodyti nereikšmingas, tačiau toks nėra. Viskas, kas kitu atveju reikalautų, jog kas nors atidarytų žiniatinklio konsolę ir spustelėtų, čia tampa automatizuojama – atsekama, atkuriama ir integruojama su įrankiais, kuriuos tavo komandos jau naudoja.
Sukurk ir atnaujink raktus
Raktų kūrimas per API leidžia automatizuoti naujos programos ar aplinkos paruošimą:
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"
}'
Šio užklausos parametrai visiškai apibrėžia rakto taikymo sritį:
- name: Žmogui suprantamas rakto identifikatorius
- acls: Leidimų sąrašas (autorizuoti galiniai taškai ir modeliai)
- qps/qpm/tpm: Ribos per sekundę, per minutę ir žetonų skaičius per minutę
- expireTime: Automatinio galiojimo pabaigos data
Nustatymas expireTime kūrimo metu yra įprotis, kuris ilgainiui sutaupo daugiausiai rūpesčių: raktas, išduotas trims mėnesiams trunkančiam bandomajam projektui, galioja tik nustatytą laiką, o ne lieka neribotam laikui konfigūracijos faile, kurio niekas nebeskaito.
Reguliarus raktų atnaujinimas laikomas tos pačios saugumo higienos dalimi. Specializuotas galinis taikas sugeneruoja naują slaptąjį raktą ir panaikina senąjį:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Įspėjimas: senasis slaptasis raktas panaikinamas nedelsiant ir visam laikui. Prieš vykdydamas komandą, o ne po jos, pasiruošk naująją reikšmę įdiegti savo slapčių valdyklėje. Trys tik skaitymui skirti galiniai taškai užbaigia šį rinkinį: GET /auth/teams/{teamId}/api-keys išvardija visus komandos raktus, GET /auth/api-keys/{apiKeyId}/propagation patikrina, ar raktas paskirstytas visuose mazguose, o GET /auth/teams/{teamId}/models išvardija pasiekiamus modelius su jų kainomis. Antrasis yra tas, kurį tikrini iškart po atnaujinimo, kai programa vis dar grąžina autentifikavimo klaidas ir nežinai, ar tai programos klaida, ar tiesiog platinimo delsos laikas.
Stebėk ir valdyk sąskaitas faktūras
Sąskaitų faktūrų informacijos gavimui naudojamas specialus galinis taškas:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Sąskaitų faktūrų istoriją gali gauti filtruodamas pagal laikotarpį, štai 2026 m. kovui:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Kiekviena sąskaita faktūra turi vieną iš šių būsenų: PENDING, PAID, FAILED ir WILL_NEVER_BE_CHARGED. Būsenos FAILED fiksavimas tavo stebėsenos sistemoje yra daug geriau nei sužinoti apie incidentą pirmadienio rytą patyrus paslaugos sutrikimą.
Norėdamas išvengti biudžeto viršijimo, nustatyk mėnesio 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}'
Jei dirbi išankstinio apmokėjimo režimu, likutį tikrink taip pat:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Atmink, kad išankstinio apmokėjimo kreditai yra negražinami, nebent to reikalauja įstatymai. Pirkimų apimtis planuok remdamasis kelių savaičių vartojimo stebėjimais, o ne optimistiniais augimo prognozėmis.
Stebėk savo vartojimą tinkamu detalumo lygmeniu
Analitikos galinis taškas leidžia stebėti naudojimą labai detaliai:
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"]
}
}'
Ši užklausa grąžina dieninį žetonų suvartojimą, suskirstytą pagal modelius, kovos mėnesiui. Pakeitus timeUnit, gali pereiti nuo mėnesio vaizdo prie vaizdo kas minutę: galimos reikšmės yra MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR ir MINUTE. Agregacijos apima daug daugiau nei paprastas sumas: SUM, AVG, MIN, MAX, P50, P90, P99 ir COUNT. Percentiliai efektyviai apibūdina apkrovą, nes vidurkiai išlygina būtent tuos šuolius, kurie lemia tau iš tikrųjų reikalingą pajėgumą.
„Management API“ tada užima savo vietą tavo įrankių grandinėje. Raktus paruoši iš „Terraform“ arba „Pulumi“ taip pat kaip ir duomenų bazę, tavo CI/CD vamzdynas sukuria laikinus raktus testavimo aplinkoms ir juos ištrina vykdymo pabaigoje, stebėsenos scenarijai įspėja prieš pasiekiant išlaidų limitą, o tavo vidinės skydeliai rodo vartojimą be žmogaus poreikio kas pirmadienį eksportuoti CSV failą.
Svarbiausi punktai
- „Management API“ adresu management-api.x.ai valdo raktus, sąskaitas faktūras ir metrikas
- Rakto atnaujinimas visam laikui panaikina senąjį slaptąjį raktą
- Išlaidų limitai apsaugo nuo biudžeto viršijimo
- Naudojimo analitika suteikia detalumą nuo minutės iki mėnesio
- Integruok „Management API“ į savo infrastruktūros įrankius, kad automatizuotum administravimą